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Real-Time C Debugger — Overview 



The Real-Time C Debugger is a MS Windows application that lets you debug 
C language programs for embedded microprocessor systems. 

The debugger controls HP 64700 emulators and analyzers either on the local 
area network (LAN) or connected to a personal computer with an RS-232C 
interface or the HP 64037 RS-422 interface. It takes full advantage of the 
emulator's real-time capabilities to allow effective debug of C programs while 
running in real-time. 

The debugger is a MS Windows application 

• You can display different types of debugger information in different 
windows, just as you display other windows in MS Windows applications. 

• You can complete a wide variety of debug-related tasks without exiting 
the debugger. You can, for example, edit files or compile your programs 
without exiting the debugger. 

• You can cut text from the debugger windows to the clipboard, and 
clipboard contents may be pasted into other windows or dialog boxes. 

The debugger communicates at high speeds 

• You can use the HP 64700 LAN connection or the RS-422 connection for 
high-speed data transfer (including program download). These 
connections give you an efficient debugging environment. 

You can debug programs in C context 

• You can display C language source files (optionally with intermixed 
assembly language code) . 

• You can display program symbols. 

• You can display the stack backtrace. 

• You can display and edit the contents of program variables. 

• You can step through programs, either by source lines or assembly 
language instructions. 

• You can step over functions. 

• You can run programs until the current function returns. 

• You can run programs up to a particular source line or assembly language 
instruction. 



• You can set breakpoints in the program and define macros (which are 
collections of debugger commands) that execute when the breakpoint is 
hit. Break macros provide for effective debugging without repeated 
command entry. 

You can display and modify processor resources 

• You can display and edit the contents of memory locations in 
hexadecimal or as C variables. 

• You can display and edit the contents of microprocessor registers 
including on-chip peripheral registers. 

• You can display and modify individual bits and fields of bit-oriented 
registers. 

You can trace program execution 

• You can trace control flow at the C function level. 

• You can trace the callers of a function. 

• You can trace control flow within a function at the C statement level. 

• You can trace all C statements that access a variable. 

• You can trace before, and break program execution on, a C variable being 
set to a specified value. 

• You can make custom trace specifications. 

You can debug your program while it runs continuously at full speed 

• You can configure the debugger to prevent it from automatically 
initiating any action that may interrupt user program execution. This 
ensures that the user program executes in real-time, so you can debug 
your design while it runs in a real-world operating mode. 

• You can inspect and modify C variables and data structures without 
interrupting execution. 

• You can set and clear breakpoints without interrupting execution. 

• You can perform all logic analysis functions, observing C program and 
variable activity, without interrupting program execution. 
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In This Book 



This book documents the Real-Time C Debugger for M37700. It is organized 
into five parts whose chapters are described below. 

Part 1. Quick Start Guide 

Chapter 1 quickly shows you how to use the debugger. 

Part 2. User's Guide 

Chapter 2 shows you how to use the debugger interface. 
Chapter 3 shows you how to plug the emulator into target systems. 
Chapter 4 shows you how to configure the emulator. 
Chapter 5 shows how to debug programs. 

Part 3. Reference 

Chapter 6 contains a summary of the debugger commands as they are 
used in command files and break macros. 

Chapter 7 describes the format for expressions used in commands. 
Chapter 8 describes commands that appear in the menu bar. 
Chapter 9 describes commands that appear in debugger window control 
menus. 

Chapter 10 describes commands that appear in popup menus. 

Chapter 1 1 describes commands that are only available in command files 

and break macros. 

Chapter 12 describes error messages and provides recovery information. 

Part 4. Concept Guide 

Chapter 13 contains conceptual (and more detailed) information on 
various topics. 

Part 5. Installation Guide 

Chapter 14 shows you how to install the debugger. 

Chapter 15 shows you how to install or update HP 64700 firmware. 
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Getting Started 



This tutorial helps you get comfortable by showing you how to perform some 
measurements on a demo program. This tutorial shows you how to: 

1 Start the debugger. 

2 Setting the Hardware Options. 

3 Set the reset value for the stack pointer. 

4 Map memory for the demo program. 

5 Load the demo program. 

6 Display the source file. 

7 Set a breakpoint. 

8 Run the demo program. 

9 Delete the breakpoint. 

10 Single-step one line. 

11 Single-step 10 lines. 

12 Display a variable. 

13 Edit a variable. 

14 Monitor a variable in the WatchPoint window. 

15 Run until return from current function. 

16 Step over a function. 

17 Run the program to a specified line. 

18 Display register contents. 

19 Trace function flow. 

20 Trace a function's callers. 

21 Trace access to a variable. 

22 Exit the debugger. 

Demo programs are included with the Real-Time C Debugger in the 
C:\HP\RTC\M7700\DEMO directory (if C:\HP\RTC\M7700 was the 
installation path chosen when installing the debugger software). 

Subdirectories exist for the SAMPLE demo program, which is a simple C 
program that does case conversion on a couple strings, and for the ECS demo 
program, which is a somewhat more complex C program for an 
environmental control system. 

Demo program is written for IAR language tools. 



Chapter 1: Getting Started 



Each of these demo program directories contains a README file that 
describes the program and batch files that show you how the object files were 
made. 

This tutorial shows you how to perform some measurements on the SAMPLE 
demo program. 
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Chapter 1: Getting Started 
Step 1. Start the debugger 



Step 1. Start the debugger 

• Open the HP Real-Time C Debugger group box and double-click the 
M37700 debugger icon. 

Or: 

1 Choose the File— >Run (ALT, F, R) command in the Windows Program 
Manager. 

2 Enter the debugger startup command, C:\HP\RTC\M7700\B3630.EXE 
(if C:\HP\RTC\M7700 was the installation path chosen when installing 
the debugger software). 

3 Choose the OK button. 
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Chapter 1: Getting Started 
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Step 2. Setting Hardware Options 

You need to configure Hardware Options before using the emulator. The 
demo program runs under processor mode as proc!6. 



1 Choose the Settings— >Emulator config— >Hardware... (ALT, S, E, H) 
command. 

2 Select "procl6" in the Processor Mode group box. 

3 Choose the Apply button. 



Hardware Config 



'•: Inter nal O External 

l 7702M2 1 \* 



Clock Source 
Processor Type 
Processor Mode |l.lr.fAlf 
Enable High Speed Access 

Introduce /RDY input 
Enable Watchdog Timer 
Enable Break on Write to ROM 
Processor Clock is Faster than 16MHz 



I 0K I 



Tool Type 
■• IAR O MRI O Mitsubishi 



Memory Model 
<•> small O 



edium 



Cancel 



□ 
□ 
□ 
□ 
□ 



Apply 



Help [ 



O banked 



4 Choose the OK button to exit. 



Note 



Demo program is written for IAR language tools. 
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Step 3. Set the reset value for the stack pointer 



Step 3. Set the reset value for the stack pointer 

1 Choose the Settings^Emulator Config^Monitor... (ALT, S, E, O) 
command. 

2 Enter "OffOO" in the Reset Value for Stack text box. 



IVPe 
Stack 



Monitor Config 



: Background: O Foreground 



Reset Value for Stack Pointer 



OffOO 



NOTE: Must reset piocessoi to take effect 



foreground i>«Uings " 
Monitor AfWrevv 



Monitor Hatm-,: 



OK 



Cancel 



Apply 



Help J 



Browse. 



NOTE: Must reset piocessoi to cause load of monitor file 



3 Choose the OK button. 

The HP 64146/7 emulator requires the stack pointer to be set to an even 
address in emulation RAM or in target system RAM. 

When you break the emulation processor from the EMULATION RESET state 
into the RUNNING IN MONITOR state, the stack pointer is set to the address 
specified. 



Note 



Breaking into the monitor from a state other than EMULATION RESET does 
not cause the stack pointer to be modified. (The Execution-»Reset (ALT, E, 
E) command places the emulator in the EMULATION RESET state.) 
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Step 4. Map memory for the demo program 

Because the emulator can use target system memory as well as emulation 
memory, you must tell the emulator which type of memory is to be used for 
particular address ranges. 

The demo program reserves addresses Oh-Offffh for RAM. Map this address 
range as emulation memory. 

1 Choose the Settings^Emulator Config^Memory Map... (ALT, S, E, 
M) command. 

2 Choose the Delete All button to delete current memory map. 

3 Enter "0" in the Start text box. 

4 Tab the cursor to the End text box and enter "Offff". 

5 Select "eram" in the Type option box. 
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Step 4. M ap memory for the demo program 



6 Choose the Apply button. 



Memory Map Config 



Define Map Term 
Start: || ~| 
End: | | 
Type 

® eiam O eiom O tram 



O tiom O guarded 



A ""' y 1 



Default 

® tram O trom O guarded 



Current Map 



0000000 . OOOffff era 



Available: 



Delete 



446 Kbytes 
Delete Al | 



7 Choose the Close button. 
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Step 5. Load the demo program 

1 Choose the File— >Load Object... (ALT, F, L) command. 

2 Choose the Browse button and select the sample program object file, 
C:\HP\RTC\M7700\DEMO\SAMPLE\SAMPLE.X (if C:\HP\RTC\M7700 
was the installation path chosen when installing the debugger 
software). This program is written for IAR language tools. 

3 Choose the OK button in the Object File Name dialog box. 

4 Choose the Load button. 
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Step 6. Display the source file 

To display the sample. c source file starting from the main function: 

1 If the Source window is not open, double-click on the Source window 
icon to open the window. Or, choose the Window— >Source 
command. 

2 From the Source window's control menu, choose 
Search— >Function... (ALT, -, R, F) command. 

3 Select "main". 

4 Choose the Find button. 

5 Choose the Close button. 



6 From the Source window's control menu, choose the display 
— >Source Only(ALT, -, D, S) command. 





Source 


E 




Filename : 


c :\hp\rtc \m7700Sde no \s ample \s anple .c 






80065 
80066 
tt0067 
80068 
80069 
80070 
80071 


main (no id) 

< 

init_dataO; 

while(l> 

{ 

convert (message _id> ; 

message id = next _message (message id>; 






80072 
80073 


> 

> 






* '311 







The window displays sample. c source file, starting from main function. 
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Step 7. Set a breakpoint 

To set a breakpoint on line 70 in sample.c: 
1 Cursor-select line 70. 



2 Choose the Breakpoint— >Set at Cursor (ALT, B, S) command. 



Source 



File name : c:\hpSrtc\m7700\derno\sample\sample.c 



80065 main < void) 

80066 < 

(10067 init_dataO; 

80068 while<l> 

80069 < 

BP 80070 | convert <nessage_id>; 

80071 message_id = next_message <message_id> ; 

80072 > 

80073 > 



J 



Notice that line 70 is marked with "BP" which indicates a breakpoint has been 
set on the line. 
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Step 8. Run the demo program 

To run the demo program from the transfer address: 

1 Choose the Execution— >Reset (ALT, E, E) command followed by the 
Execution— >Break (ALT, E, B) command to initialize the stack 
pointer. 

2 Choose the Execution— >Run... (ALT, E, R) command. 

3 Select the Start Address option. 

4 Choose the Run button. 







Source 


1 T 




Filename : 


c :\hp\rtc\m?700\demo\sai>iple\sample .c 






80865 
B006G 
B0067 
80068 
«0069 


main < void) 
< 

in it_dataO ; 
while<l> 

{ 




□ 


BP H0070 




convert <messa«e_id> ; 






80071 
U0072 
80073 


> 


message _id = next_nessage (message _id> ; 














□ 



Notice the demo program runs until line 70. The highlighted line indicates 
the current program counter. 
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Step 9. Delete the breakpoint 

To delete the breakpoint set on line 70: 

1 Cursor-select line 70. 

2 Choose the Breakpoint— >Delete at Cursor (ALT, B, D) command. 

The "BP" marker disappears in the Source window. 
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Step 10. Single-step one line 

To single-step the demo program from the current program counter: 



• Choose the Execution— >Single Step (ALT, E, N) command. Or, press 
the F2 key. 

Notice the C statement executed and the program counter is at the "convert" 
function. 
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Step 11. Single-step 10 lines 

To single-step 10 consecutive executable statements from the current PC line: 

1 Choose the Execution— >Step... (ALT, E, S) command. 

2 Select the Current PC option. 

3 Enter "10" in the Count text box. 



From 
<§> Current PC 

O Address: 



Count: 10| 



Step 



Close 



Stop I 



Help 



□ Over 

□ Follow PC 



4 Choose the Step button. Notice that the step count decrements by 
one as the program executes step by step. The step count stops at 1. 



5 Choose the Close button. 
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Step 12. Display a variable 

To display the contents of auto variable "*mes": 

1 Drag "*mes" on line 31 in the Source window until it is highlighted. 

2 Choose the Variable— >Edit... (ALT, V, E) command. 



Variable Edit 



Variable: 



Jjppe: unsigned char 
Value 



72 (48H) -H- 




Update | Modify | to WP | 



Close 



Help | 



Note 



The Variable text box displays "*mes". 

Notice the Value list box displays the contents of "*mes". 

You can only register or display an auto variable as a watchpoint while the 
program counter is within the function in which the variable name is declared. 



38 



Chapter 1: Getting Started 
Step 13. Edit a variable 



Step 13. Edit a variable 

To edit the contents of variable "*mes": 

1 In the Variable Edit dialog box, choose the Modify button. 

2 Enter "41" in the Value text box. 



Q Variable Modify 


Variable: Tries 

Type: unsigned char 


OK ] 
Cancel 


Value: 41 1 






Help | 



3 Choose the OK button. 

4 Notice the contents in the Value list box has changed to "41". 



39 



Chapter 1: Getting Started 

Step 14. Monitor a variable in the W ate hPoint window 



Step 14. Monitor a variable in the WatchPoint window 

The WatchPoint window lets you define a set of variables that may be looked 
at and modified often. For these types of variables, using the WatchPoint 
window is more convenient than using the Variable— >Edit... (ALT, V, E) 
command. 

To monitor the variable "*mes" in the WatchPoint window: 

1 In the Variable Edit dialog box, choose the "to WP" button. 

2 Choose the Close button. 

3 Choose the Window— > WatchPoint command. 





*i*es = 65 <41H) 'A' 




Notice the variable "*mes" has been registered as a watchpoint. 
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Step 15. Run until return from current function 

To execute the program until "convert_case" (the current PC function) 
returns to its caller: 

1 Choose the Execution— >Run to Caller (ALT, E, T) command. 

The program executes until the line that called "convert_case". 

2 Choose the Execution— >Single Step (ALT, E, N) command (or press 
the F2 key) to go to the line that follows the return from the 
"convert_case:" function. 
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Step 16. Step over a function 

To step over "change_status": 

• Choose the Execution— >Step Over (ALT, E, O) command. Or, press 
the F3 key. 

The "change_status" function executes, and the program counter indicates 
line 42. 
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Step 17. Run the program to a specified line 

To execute the demo program to the first line of "next_message": 

1 Cursor-select line 58. 

2 Choose the Execution— >Run to Cursor (ALT, E, C) command. 





Source Q[ 


3 


Filename : 


c :\hp\rtc\n7700\deno\sanple\sanple .c 




80048 
80049 
110050 
80051 
80052 
80053 
80054 
80055 
80056 
00057 


void 

convertdnt id> /* Message Conversion */ 

< 

convert _case(data+id> ; 

data [id] .status = change _status (data [ id ]. sta 

> 

int 

next_message ( int id) /* Change message to be 

{ 


□ 


80058 


if (id == MESSAGED 




110059 
80060 
80061 
80062 
80063 


return(MESSAGE2>; 

else 

return(MESSAGEl); 

> 




_n 




♦1 



The program executes and stops immediately before line 58. 
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Step 18. Display register contents 

1 Choose the Window— >Register command. 



£j| Basic Registers HI 




NAME UALUE 


DESCRIPTION 




A=205C 


Accumulator A 




B=0000 


Accumulator B 




X=0000 


Index X 


| 




Index V 




SP=2251 


Stack Pointer 




DT=00 


Data Bank 




PG=00 


Program Bank 




PC=80D1 


Program Counter 




DPR=205C 


Direct Page 




PS =0004 


Processor Status 




! i '. '. 




f 



The Register window opens and displays the register contents. The display is 
updated periodically. To run the program and see how the contents of the 
registers change: 

2 Choose the Execution— >Run (ALT, E, U) command. Or, press the F5 
key. 
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3 To prevent the register display from being updated, choose the 
RealTime— >Monitor Intrusion— >Disallowed (ALT, R, T, D) command. 



Basic Registers 



NAME UALUE DESCRIPTION 



A=- 
B=- 
X=- 



V= 

SP 

DT= 

PG= 

PC= 

DPP= 

PS 



Accumulator fi 
Accumulator B 
Index X 
Index V 
Stack Pointer 
Data Bank 
Program Bank 
Program Counter 
Direct Page 
Processor Status 



Notice that register contents are replaced with " — " in the display. This 
shows the debugger cannot update the register display. 



4 Choose the RealTime— >Monitor Intrusion— >Allowed (ALT, R, T, A) 
command to deselect the real-time mode. 
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Step 19. Trace function flow 



• Choose the Trace— >Function Flow (ALT, T, F) command. 



The Trace window becomes active and displays execution flow as shown 
below. 



Trace - Loading Data ( Frame: 1] 



state 


typ 


moduleWttline 


function 


source 


M 




I 2 


SEQ 


sample\\80038 


convert 


< 


1.200 


uS"TG 


6 


SEQ 


sanple\\tt0044 


:convert_case 


< 


14.40 


uS 


12 


SEQ 


sanple\\tt0054 


: change _st at u 


< 


232.4 


uS 


20 


SEQ 


san>ple\\80062 


:next jnessage 


< 


27.60 


uS 


24 


SEQ 


sanple\\tt0038 


:convert 


< 


17.00 


uS 


28 


SEQ 


sample\\80044 


: convert _case 


< 


14.40 


uS 


34 


SEQ 


sample\\80054 


: change _statu 


< 


323.1 


uS 


42 


SEQ 


sample\\tt0062 


:next_message 


< 


26.80 


uS 


46 


SEQ 


sample\\tt0038 


convert 


< 


16.20 


uS 


50 


SEQ 


sanple\\tt0044 


:conwert_case 


< 


14.40 


uS 


56 


SEQ 


sampleS\H0054 


: change _statu 


< 


254.0 


uS 


64 


SEQ 


sanpleS\H0062 


:next_message 


< 


26.80 


uS 


68 


SEQ 


sanple\\80038 


^convert 


< 


17.00 


uS 


72 


SEQ 


sample\\tt0044 


: conuert_case 


< 


14.40 


uS 



The command traces, and stores in trace memory, only the entry points to 
functions. This lets you check program execution flow. 
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Step 20. Trace a function's callers 

To trace the caller of "next_message": 

1 Double-click "next_message" on line 56 in the Source window. 

2 Choose the Trace— >Function Caller... (ALT, T, C) command. 



Function Caller Trace 




3 Choose the OK button. 



The Trace window becomes active and displays the caller as shown below. 





Trace 


■ Loading Data ( Frame: 1] 






St 


ate typ nodule Wit line 


function source K<| 




>>| 



2 
3 
5 
6 

8 PRE 

9 
11 
12 
14 PRE 
15 

17 PRE 
18 

20 PRE 
21 



PRE 
PRE 



PRE 



sample\\tt0071 
sampleV\tt00S7 
sample\\tt0071 
sample\\it0057 
sample\\ft0071 
sample\\tt00S7 
sanple\\tt0071 
sample\\tt0057 
sanple\\80071 
sample\\it0057 
sample\\ft0071 
sample\\it00S7 
sample\\tt0071 
sample\\it00S7 



main 

next_message 
main 

next_message 
main 

next_message 
main 

next_message 
main 

next_message 
main 

next_message 
main 

next_message 



messag 
messag 
messag 
messag 
messag 
messag 
messag 



prestore^TG I* 
306.4 uS 
prestore 
405.9 uS 
prestore 
505.4 uS 
prestore 
363.2 uS 
prestore 
460.6 uS 
prestore 
405.9 uS 
prestore 
505.4 uS 



This command stores the first statement of a function and prestores 
statements that occur before the first statement (notice the state type PRE). 
The prestored statements show the caller of the function. In the above 
example, "next_message" is called by line 71 of "main". 
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Step 21. Trace access to a variable 

To trace access to variable "message_id": 

1 Double-click "message_id" on line 70 in the Source window. 

2 Choose the Trace— > Variable Access... (ALT, T, V) command. 



Variable Access Trace 



Variable: 



message id 



Cancel | 



Help | 



3 Choose the OK button. 

The Trace window becomes active and displays accesses to "message_id" as 
shown below. 



rrace - Loading Data [ Frame: 1] 



state typ module Wttline 



1 PRE 
4 PRE 
7 PRE 
9 PRE 
12 PRE 
15 PRE 
17 PRE 
20 PRE 
23 PRE 
PRE 
PRE 
31 PRE 
33 PRE 
36 PRE 



25 
28 



sampleS\80053 
sample\\tt007i 
sampleS\H0070 
sample\\J»0053 
sampleS\80071 
sample\\tt007O 
sample\\80053 
sample\\tt0071 
sample\\tt007O 
sample\\tt0053 
sample\\80071 
sample\\tt007fl 
sampleS\80053 
sample\\tt0071 



function 



convert 

main 

main 

convert 

main 

main 

convert 

main 

main 

convert 

main 

main 

convert 

main 



messag 
conver 



messag 
conver 



messag 
conver 



messag 
conver 



messag 



>> 



prestore^TG 

prestore 

prestore 

prestore 

prestore 

prestore 

prestore 

prestore 

prestore 

prestore 

prestore 

prestore 

prestore 

prestore 
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Step 22. Exit the debugger 

1 Choose the File— >Exit (ALT, F, X) command. 

2 Choose the OK button. 

This will end your Real-Time C Debugger session. 
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Part 2 



User's Guide 



A complete set of task instructions and problem-solving guidelines, with a 
few basic concepts. 
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Using the Debugger Interface 



This chapter contains general information about using the debugger interface. 

• How the Debugger Uses the Clipboard 

• Debugger Function Key Definitions 

• Starting and Exiting the Debugger 

• Working with Debugger Windows 

• Using Command Files 
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How the Debugger Uses the Clipboard 

Whenever something is selected with the standard windows double-click, it is 
placed on the clipboard. The clipboard can be pasted into selected fields by 
clicking the right mouse button. 

Double-clicks are also used in the Register and Memory windows to make 
values active for editing. These double-clicks also copy the current value to 
the clipboard, destroying anything you might have wanted to paste into the 
window (for example, a symbol into into the memory address field). In 
situations like this, you can press the CTRL key while double-clicking to 
prevent the selected value from being copied to the clipboard. This allows 
you to, for example, double-click on a symbol, CTRL+double-click to activate 
a register value for editing, and click the right mouse button to paste the 
symbol value into the register. 

Many of the Real-Time C Debugger commands and their dialog boxes open 
with the clipboard contents automatically pasted in the dialog box. This 
makes entering commands easy. For example, when tracing accesses to a 
program variable, you can double-click on the variable name in one of the 
debugger windows, choose the Trace— > Variable Access... (ALT, T, V) 
command, and click the OK button without having to enter or paste the 
variable name in the dialog box (since it is has automatically been pasted in 
the dialog box). 
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Debugger Function Key Definitions 

Fl Accesses context sensitive help. Context sensitive help is 

available for windows, dialog boxes, and menu items. 

F2 Executes a single source line from the current program 

counter address (or a single instruction if disassembled 
mnemonics are mixed with source lines in the Source 
window) . 

F3 Same as F2 except when the source line contains a 

function call (or the assembly instruction makes a 
subroutine call); in these cases, the entire function (or 
subroutine) is executed. 

F4 Break emulator execution into the monitor. You can use 

this to stop a running program or break into the monitor 
from the processor reset state. 

F5 Runs the program from the current program counter 

address. 

Shift-F4 Tiles the open debugger windows. 

Shift-F5 Cascades the open debugger windows. 

F7 Repeats the trace command that was entered last. 

Ctrl+F7 Halts the current trace. 
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Starting and Exiting the Debugger 

This section shows you how: 

• To start the debugger 

• To exit the debugger 

• To create an icon for a different emulator 



To start the debugger 

• Double-click the debugger icon. 

Or: 

1 Choose the File— >Run (ALT, F, R) command in the Windows Program 
Manager. 

2 Enter the debugger filename, C:\HP\RTC\M7700\B3630.EXE (if 
C:\HP\RTC\M7700 was the installation path chosen when installing 
the debugger software). 

3 Choose the OK button. 

You can execute a command file when starting the debugger by using the 
"-C<command_file>" command line option. 
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To exit the debugger 

1 Choose the File— >Exit (ALT, F, X) command. 

2 Choose the OK button. 

This will end your Real-Time C Debugger session. 



To create an icon for a different emulator 

1 Open the "HP Real-Time C Debugger" group box, or make it active by 
positioning the mouse in the window and clicking the left button. 

2 Choose the File— >New... (ALT, F, N) command in the Windows 
Program Manager. 

3 Select the Program Item option and choose OK. 

4 In the Description text box, enter the icon description. 

5 In the Command Line text box, enter the 
"C:\HP\RTC\M7700\B3630.EXE -T<transport> -E<connectname>" 
command (if C:\HP\RTC\M7700 was the installation path chosen 
when installing the debugger software). The "-T" and "-E" startup 
options allow you to bypass the transport and connect name 
definitions in the B3630.INI file. 

<Transport> should be one of the supported transport options (for example, 
HP-ARPA, RS232C, etc.). 

<Connectname> should identify the emulator for the type of transport. For 
example, if the HP-ARPA transport is used, <connectname> should be the 
hostname or IP address of the HP 64700; if the RS232C transport is used, 
<connectname> should be COM1, COM2, etc. 
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6 In the Working Directory text box, enter the directory that contains 
the debugger program (for example, C:\HP\RTC\M7700). 

7 Choose the OK button. 



59 



Chapter 2: Using the Debugger Interface 
Working with Debugger Windows 

Working with Debugger Windows 

This section shows you how: 

• To open debugger windows 

• To copy window contents to the list file 

• To change the list file destination 

• To change the debugger window fonts 

• To set tabstops in the Source window 



To open debugger windows 

• Double-click the icon for the particular window. 

• Or, choose the particular window from the Window— > menu. 

• Or, choose the Window— >More Windows... (ALT, W, M) command, 
select the window to be opened from the dialog box, and choose the 
OK button. 



To copy window contents to the list file 

• From the window's control menu, choose the Copy— > Windows (ALT, 
-, P, W) command. 

The information shown in the window is copied to the destination list file. 
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You can change the name of the destination list file by choosing the 
Copy— ^Destination... (ALT, -, P, D) command from the window's control 
menu or by choosing the File— >Copy Destination... (ALT, F, P) command. 



To change the list file destination 

• Choose the File— >Copy Destination... (ALT, F, P) command, and 
select the name of the new destination list file. 

• Or, from the window's control menu, choose the 

Copy —destination... (ALT, -, P, D) command, and select the name of 
the new destination list file. 

Information copied from windows will be copied to the selected destination 
file until the destination list file name is changed again. 

List file names have the ".LST" extension. 



To change the debugger window fonts 

1 Choose the Settings^Font (ALT, S, F) command. 

2 Select the font, font style, and size. Notice that the Sample box 
previews the selected font. 

3 Choose the OK button. 
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To set tab stops in the Source window 

1 Choose the Settings— >Tabstops (ALT, S, T) command. 

2 Select the font, font style, and size. Notice that the Sample box 
previews the selected font. 

3 Choose the OK button. 



62 



Chapter 2: Using the Debugger Interface 
Using Command Files 



Using Command Files 

This section shows you how: 

• To create a command file 

• To execute a command file 

• To create buttons that execute command files 

A command file is an ASCII text file containing one or more debugger 
commands. All the commands are written in a simple format, which makes 
editing easy. The debugger commands used in command files are the same 
as those used with break macros. For details about the format of each 
debugger command, refer to the "Reference" information. 



To create a command file 

1 Choose the File^Command Log^Log File Name... (ALT, F, C, N) 
command. 

2 Enter the command file name. 

3 Choose the File^Command Log^Logging ON (ALT, F, C, O) 
command. 

4 Choose the commands to be stored in the command file. 

5 Once the commands have been completed, choose the 
File^Command Log^Logging OFF (ALT, F, C, F) command. 

Command files can also be created by saving the emulator configuration. 
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To execute a command file 

1 Choose the File— >Run Cmd File... (ALT, F, R) command. 

2 Select the command file to be executed. 

3 Choose the Execute button. 

You can execute command files that have been created by logging commands. 

Also, emulator configurations can be restored by executing the associated 
command file. 



Example 



Command File Being Executed 



Run Command File 



File Name: 



C:\HP\RTC\M7700\DEMO\SAMPLE\SAMPLE.E 



D irectoiy : c:\... \m7700\demo\sample 



sampdemo.cmd 
sampemul.cmd 
sample cmd 



Execute 



Stop 
Close 



Parameters: 



Executing: 



Bmwse ... j 
Help | 
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To create buttons that execute command files 

1 Activate the Button window by clicking on the Button window icon 
or by choosing the Window— >Button command. 

2 From the Button window's control menu, choose the Edit... (ALT, -, 
E) command. 

3 In the Command text box, enter "FILE COMMAND", a space, and the 
name of the command file to be executed. 

4 Enter the button label in the Name text box. 

5 Choose the Add button. 

6 Choose the Close button. 

Once a button has been added, you can click on it to run the command file. 
You can also set up buttons to execute other debugger commands. 
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Plugging the Emulator into Target Systems 



This chapter shows you how: 

• To plug-in the HP 64146/7 emulator 

• To configure the emulator for in-circuit operation 

Possible Damage to the Emulation Pod. The HP 64146/7 emulator contains 
devices that are susceptible to damage by static discharge. Therefore, 
operators should take precautionary measures before handling the emulation 
pod to avoid emulator damage. 



Maximum clock speed of HP 64146/7 emulators are 25MHz. These emualtors 
do not support any operation with clock faster than 25MHz. 
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To plug-in the HP 64146/7 emulator 

To prevent emulator and pod components from being damaged by static 
electricity, store and use the emulator in a place resistant to static electricity. 



1 Power OFF the target system; then, power OFF the emulator. 

2 Set up the switches inside the emulation pod. Refer to the manual 
provided with your emulation pod. 

3 Remove the processor from the target system. 

4 Connect the emulation pod to the target system so that pod pin 1 is 
inserted into target system socket pin 1 (see the figures that follow). 

5 Power ON the target system; then, power ON the emulator. 

6 Start the debugger. 



Note Your target system must have a clock generation circuit. The emulation pod 

cannot generate clock signal using a ceramic (or quartz crystal) resonator. 
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LCC80 Socket Connection 

Connect the emulation pod so that probe pin 1 is inserted into target system 
socket pin 1. 




SDIP64 Socket Connection 

When your target system uses 64 pin shrink DIP socket, use the adaptor as 
shown in below, and connect the emulation pod so that pod pin 1 is inserted 
into adaptor socket pin 1. 
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To configure the emulator for in-circuit operation 

The following outlines the emulator configuration for in-circuit emulation. 
For details on each configuration option, refer to the "Configuring the 
Emulator" chapter. 

• Select the target system clock as the emulator clock source by 

choosing Settings— >Emulator Config— >Hardware... (ALT, S, E, H) and 
selecting the External option. 
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Configuring the Emulator 



This chapter contains information about configuring the emulator. 

• Setting the Hardware Options 

• Mapping Memory 

• Selecting the Type of Monitor 

• Setting the Trace Options 

• Setting the Pod Configuration 

• Setting Up the BNC Port 

• Saving and Loading Configurations 

• Setting the Real-Time Options 



Chapter 4: Configuring the Emulator 
Setting the Hardware Options 



Setting the Hardware Options 

This section shows you how: 

• To select the emulator clock source 

• To select the processor type 

• To select the processor mode 

• To enable or disable High Speed Access 

• To enable or disable introduce /RDY signal 

• To enable or disable Watchdog Timer 

• To enable or disable break on write to ROM 

• To specify a clock speed faster than 16MHz 

• To select tool type 

• To select memory model 



To select the emulator clock source 

1 Choose the Settings^Emulator Config^Hardware... (ALT, S, E, H) 
command. 

2 Select either the Internal or External option for the emulator clock 
source. 

3 Choose the OK button to exit the Hardware Config dialog box. 

Selects either the emulator or target system clock. 

Internal Selects the emulator clock (1,8,16,25MHz) for debugging 

without the target system. These frequencies can be 
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selected by the switches on the clock circuit board in the 
emulation pod. 

External Selects the target system clock for synchronous 

emulator-target system operation. You must use a clock 
input conforming to the specification for the M37700 Series 
microprocessor. 

Note Maximum clock speed of HP 64146/7 emulators are 25MHz. These emualtors 

do not support any operation with clock faster than 25MHz. 



Note When the external clock is selected, your target system must have a clock 

generation circuit. The emulation pod cannot generate clock signal using 
ceramic (or quartz crystal) resonator. 



Note Changing the clock source selection resets the emulator. 



See Also 

To enable or disable high speed access and To specify a clock speed faster 
than 16MHz in the "Setting the Hardware Options" Section of the 
"Configuring the Emulator" chapter. 
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To select the processor type 

1 Choose the Settings— >Emulator Config— >Hardware... (ALT, S, E, H) 
command. 

2 Select the processor type to emulate. 

3 Choose the OK button to exit the Hardware Config dialog box. 

Selecting processor type automatically sets up internal SFR/RAM/ROM area 
and processor mode register area to the emulator. 

If your processor is not listed in supported processors, you can select "others" 
for this item. In this case, you need to set up proper value for internal 
SFR/RAM/ROM and processor mode register by yourself. (Choose the 
Settings-^Emulator Config-^Pod... (ALT, S, E, P) command.) 



Note Always set bus mode as low speed bus mode when you use M37751 

emulation pod. HP 64147A emulator does not support high speed bus mode. 
Note that bus mode is automatically configured as high speed bus mode when 
you execute the emulator from user reset. Then, you need to configure bus 
mode as low speed bus mode. 



Note Changing the processor type resets the emulator and clears memory 

mapping. 
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To select the processor mode 

1 Choose the Settings— >Emulator Config— >Hardware... (ALT, S, E, H) 
command. 

2 Select the processor mode to emulate. 

3 Choose the OK button to exit the Hardware Config dialog box. 



Note Changing the processor mode resets the emulator. 



To enable or disable high speed access 

1 Choose the Settings^Emulator Config^Hardware... (ALT, S, E, H) 
command. 

2 Select or deselect the Enable High Speed Access check box. 

3 Choose the OK button to exit the Hardware Config dialog box. 

When the check box is selected: 

• The emulator can access emulation memory with no wait state, up to 
25MHz. 

• You can map the emulation memory only to the following location. 
Memory: Monitor: Available location: 

128K Background 000000-01F7FF 

128K Foreground 000000-01FFFF 

512K Background 000000-07F7FF 
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512K 


Foreground 


000000-07FFFF 


IM 


Background 


000000-0FF7FF 


IM 


Foreground 


000000-OFFFFF 


2M 


Background 


000000-1FF7FF 


2M 


Foreground 


000000-1FFFFF 


When the check box is deselected: 





• You can define up to 16 different map terms which can be placed 
wherever you like. 

• The emulator can run with no wait state, up to 16MHz. 

• The emulator can run with one wait state, up to 25MHz. 



To enable or disable introduce /RDY signal 

1 Choose the Settings— >Emulator Config— >Hardware... (ALT, S, E, H) 
command. 

2 Select or deselect the Introduce /RDY input check box. 

3 Choose the OK button to exit the Hardware Config dialog box. 

When the check box is selected, the emulator activates /RDY input for one 
clock cycle, every time the emulator accesses memory. 

When the check box is deselected, the emulator inactivates /RDY input every 
time the emulator accesses memory. 

This feature is used to run the emulator with clock faster than 16MHz. When 
clock is equal or slower than 16MHz, always deselect this item. 
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To enable or disable the watchdog timer 

1 Choose the Settings— >Emulator Config— >Hardware... (ALT, S, E, H) 
command. 

2 Select or deselect the Enable Watchdog Timer check box. 

3 Choose the OK button to exit the Hardware Config dialog box. 

When the check box is selected, the watchdog timer starts counting up from 
reset state (FFF). 

When the check box is deselected, the watchdog timer does not start 
counting up. 



Note Watchdog timer suspends count down while the emulator is running in 

background monitor. 



To enable or disable break on writes to ROM 

1 Choose the Settings— >Emulator Config— >Hardware... (ALT, S, E, H) 
command. 

2 Select or deselect the Enable Break on write to ROM check box. 

3 Choose the OK button to exit the Hardware Config dialog box. 

When the check box is selected, a running program breaks into the monitor 
when it writes to a location mapped as ROM. 

When the check box is deselected, program writes to locations mapped as 
ROM do not cause breaks into the monitor. 
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To specify a clock speed faster than 16 MHz 

1 Choose the Settings— >Emulator Config— >Hardware... (ALT, S, E, H) 
command. 

2 Select or deselect the Processor Clock is Faster than 16 MHz check 
box. 

3 Choose the OK button to exit the Hardware Config dialog box. 

When tracing microprocessor execution at speeds up to 16 MHz, time can be 
counted for states stored in trace memory. 

However, if the processor clock speed is greater than 16 MHz, time cannot be 
counted. You can still count the occurrences of a qualified state. 



To select tool type 

1 Choose the Settings^Emulator Config^Hardware... (ALT, S, E, H) 
command. 

2 Select the tool type in the Tool Type option box. 

3 Choose the OK button to exit the Hardware Config dialog box. 



Note Changing the tool type resets the emulator. 



81 



Chapter 4: Configuring the Emulator 
Setting the Hardware Options 



To select the memory model 

1 Choose the Settings— >Emulator Config— >Hardware... (ALT, S, E, H) 
command. 

2 Select the memory model in the Memory Model option box. Note that 
you need to specify appropriate compile cotions when you compile 
your program. 

Memory Model 





small 


medium 


compact 


bancked 


IAR 


-ms 


-mm 


-mc 


-mb 


MRI 


-Ms 


(N/A) 


(N/A) 


-Ml 


Mitsubishi 


-fNF 


-fNF,-fFD 


no options 


-fFD 



3 Choose the OK button to exit the Hardware Config dialog box. 



Note Changing the memory model resets the emulator. 
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Mapping Memory 

This section shows you how: 

• To map memory 

• To map internal RAM and SFR 

Because the emulator can use target memory or emulation memory (or 
both), it is necessary to map range of memory so that the emulator knows 
where to direct its access. 

Up to 16 ranges of memory can be mapped, and the resolution of mapped 
ranges is 256 bytes (that is, memory ranges must begin on 256 byte 
boundaries and must be at least 256 bytes in length). 

Direct memory access (DMA) to emulation memory is not permitted. 

You should map all memory ranges used by your program before loading 
programs into memory. 
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To map memory 

1 Choose the Settings^Emulator Config^Memory Map... (ALT, S, E, 
M) command. 

2 Specify the starting address in the Start text box. 

3 Specify the end address in the End text box. 

4 Select the memory type in the Type option box. 

5 Choose the Apply button. 

6 Repeat steps 2 through 5 for each range to be mapped. 

7 Choose the Close button to exit the Memory Map dialog box. 

You can map up to 16 address ranges (map terms). The minimum amount of 
emulation memory that can be allocated to a range is 256 bytes. 

When high speed access mode is enabled in the Hardware Configuration, you 
can map the emulation memory only to one location, depending on the 
monitor type and capacity of the memory board. 

You can specify one of the following memory types for each map term: 



eram 


Specifies 


"emulation RAM". 


erom 


Specifies 


"emulation ROM". 


tram 


Specifies 


"target RAM". 


trom 


Specifies 


"target ROM". 


guarded 


Specifies 


"guarded memory" 



When breaks on writes to ROM are enabled in the emulator configuration, 
any access from the user program to any memory area mapped as ROM stops 
the emulator. 
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For non-mapped memory areas, select any of the memory types in the 
Default option box. 

To delete a map term, first select it in the Map list box; then, choose the 
Delete button. 

You should map all memory ranges used by your programs before loading 
programs into memory. 



Note The background monitor requires 2 Kbytes of emulation memory. Also, the 

foreground monitor requires 2 Kbytes of user program area and 1 map term. 



Example 



To map addresses 6000h through Offffh as an emulation RAM, specify the 
mapping term as shown below. 



Define Map Term' 
Start: 



6000 



Offff 



End: 
Tjjpe 

® eram O erom O Iran 
O tfom O guarded 



1 ^ 1 



Choose the Apply button to register the current map term. 
Then, choose the Close button to quit mapping. 
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To map internal RAM and SFR 

1 Choose the Settings^Emulator Config^Memory Map... (ALT, S, E, 
M) command. 

2 Specify the starting address of internal RAM (or SFR) in the Start text 
box. 

3 Specify the end address of internal RAM (or SFR) in the End text 
box. 

4 Select the emulation RAM as the memory type in the Type option 
box. 

5 Choose the Apply button. 

6 Repeat steps 2 through 5 for each range to be mapped. 

7 Choose the Close button to exit the Memory Map dialog box. 

The HP 64146/7 emulator use internal RAM and SFR of emulation processor 
to emulate user program. When you direct the emulator to display the 
contents of internal RAM (or SFR) area, the emulator breaks to the monitor 
and the monitor program reads the contents of memory. Therefore, 
execution of user program is suspended to perform your direction. 

However, you can configure the emulator so that write cycles are performed 
to both internal RAM (or SFR) and emulation memory. In this case, you can 
see the data written to emulation memory without suspending program 
execution. 

To use this feature, you need to map these area to emulation RAM. When 
you do this, you can display the contents of emulation memory without 
suspending memory. You still can display the contents of internal RAM (or 
SFR) by specifying "@i" syntax in display memory operation (Refer to the To 
display internal RAM and SFR ). 
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Note The contents of emulation memory is updated only when user program writes 

date to internal RAM (or SFR) area. Therefore, the contents of emulation 
memory may be different from the actual value of internal RAM. Especially, 
you should pay close attention when setting the flags of SFR. 



Note When you don't map the internal RAM and SFR area to emulation memory, 

you can access the internal RAM and SFR without appending "@i". 
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Selecting the Type of Monitor 

This section shows you how: 

• To select the background monitor 

• To select the foreground monitor 

Refer to Monitor Program Options in the "Concepts" part for a description of 
emulation monitors and the advantages and disadvantages of using 
background or foreground emulation monitors. 

Note Select the type of monitor before mapping memory because changing the 

monitor type resets the memory map. 



To select the background monitor 

1 Choose the Settings^Emulator Config^Monitor... (ALT, S, E, O) 
command. 

2 Select the Background option. 

3 Choose the OK button. 

When you power up the emulator, or when you initialize it, the background 
monitor program is selected by default. 

Reset value of stack pointer is automatically set to the end of internal RAM 
area by choosing processor type. When you use a processor that has no 
internal RAM, the stack pointer is set to FFF hex. 

When you specify the reset value of stack pointer, you need to enter a 16-bit 
address. 
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Note When the emulator breaks to the background monitor, the monitor program 

needs 5 bytes of stack. 



Note You need to reset the emulator to change the stack pointer to the reset value. 



To select the foreground monitor 

1 Edit the foreground monitor program source file to define its base 
address and processor mode register address. 

2 Assemble, link and Convert the foreground monitor. 

3 Choose the Settings^Emulator Config^Monitor...(ALT, S, E, O) 
command. 

4 Select the Foreground option. 

5 Enter the stack address in the Reset Value for Stack text box. The 
foreground monitor requires a stack to be set up in the user program. 
The stack address must be an address in a RAM area. 

6 Enter the base address of the foreground monitor in the Monitor 
Address text box. This is the same address that was defined in step 
1. 

7 Enter the name of the foreground monitor object file in the Monitor 
Name text box. 

8 Choose the OK button. 
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Note 



Use the Settings^Emulator Config^Memory Map... (ALT, S, E, M) to 
re-map the user program memory areas. Selecting the foreground 
monitor automatically resets the current memory map. 

Load the foreground monitor by choosing the Execution— >Reset 
(ALT, E, E) command or by choosing the File— >Load Object... (ALT, 
F, L) command and entering the name of the foreground monitor 
object file. 

Load the user program by choosing the File— >Load Object... (ALT, F, 
L) command and entering the name of the user program object file. 

When the monitor needs to respond to target system interrupts or must be 
modified in some other way, you can use a foreground monitor program. 

For more information on the foreground monitor, refer to the Monitor 
Program Options section in the "Concepts" chapter. 

Selecting the foreground monitor automatically resets the memory map and 
maps a new term for the foreground monitor. 
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Setting the Trace Options 

This section shows you how: 

• To enable or disable trace DMA cycles 

• To enable or disable trace Refresh cycles 

• To enable or disable trace Hold cycles 



To enable or disable Trace DMA cycles 

1 Choose the Settings— >Emulator Config— >Trace Options... (ALT, S, E, 
T) command. 

2 Select or deselect Trace DMA cycles check box. 

3 Choose the OK button to exit the Emulator Config dialog box. 

When the check box is selected, each time DMA performed, one emulation 
analyzer state will be generated to recognize the DMA cycles. 

When the check box is deselected, no analyzer state will be generated at the 
occurrence of DMA. Therefore, any DMA cycles will be ignored by the 
analyzer. 
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To enable or disable Trace Refresh cycles 

1 Choose the Settings— >Emulator Config— >Trace Options... (ALT, S, E, 
T) command. 

2 Select or deselect Trace Refresh cycles check box. 

3 Choose the OK button to exit the Emulator Config dialog box. 

When the check box is selected, refresh cycles are traced by the emulation 
analyzer. 

When the check box is deselected, refresh cycles are not traced by the 
emulation analyzer. 



To enable or disable Trace Hold cycles 

1 Choose the Settings— >Emulator Config— >Trace Options... (ALT, S, E, 
T) command. 

2 Select or deselect Trace Hold cycles check box. 

3 Choose the OK button to exit the Emulator Config dialog box. 

When the check box is selected, hold cycles are traced by the emulation 
analyzer. 
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Setting the pod configuration 

This section shows you how: 
• To select pod configuration 



To select the pod configuration 

1 Choose the Settings^Emulator Config^Pod... (ALT, S, E, P) 
command. 

2 Specify the Internal SFR address in the text box. 

3 Specify the Internal RAM address in the text box. 

4 Specify the Internal ROM address in the text box. 

5 Specify the Processor mode register address in the text box. 

6 Choose the OK button. 

These items are automatically set up by selecting processor type in Hardware 
Configuration. Therefore, you don't need to set up these items when your 
processor can be specified in Hardware Configuration. If your processor is 
not supported in Hardware Configuration (when you select "others" for the 
processor configuration item) , you need to set up proper value for these 
configuration items. 



Note Changing these items resets the emulator. 
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Setting Up the BNC Port 

This section shows you how: 

• To output the trigger signal on the BNC port 

• To receive an arm condition input from the BNC port 



To output the trigger signal on the BNC port 

• Choose the Settings^BNC^ Outputs Analyzer Trigger (ALT, S, B, O) 
command. 

The HP 64700 Series emulators have a BNC port for connection with external 
devices such as logic analyzers or oscilloscopes. 

This command enables the trigger signal to be fed to external devices. 



To receive an arm condition input from the BNC port 

• Choose the Settings^BNC^Input to Analyzer Arm (ALT, S, B, I) 
command. 

The HP 64700 Series emulators have a BNC port for connection with external 
devices such as logic analyzers or oscilloscopes. 

This command allows an external trigger signal to be used as an arm, or 
enable, condition for the internal analyzer. 
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Saving and Loading Configurations 

This section shows you how: 

• To save the current emulator configuration 

• To load an emulator configuration 



To save the current emulator configuration 

1 Choose the File— >Save Emulator Config... (ALT, F, V) command. 

2 In the file selection dialog box, enter the name of the file to which the 
emulator configuration will be saved. 

3 Choose the OK button. 

This command saves the current hardware, memory map, and monitor 
settings to a command file. 

Saved emulator configuration files can be loaded later by choosing the 
File— >Load Emulator Config... (ALT, F, E) command or by choosing the 
File->Run Cmd File... (ALT, F, R) command. 
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To load an emulator configuration 

1 Choose the File— >Load Emulator Config... (ALT, F, E) command. 

2 Select the name of the emulator configuration command file to load 
from the file selection dialog box. 

3 Choose the OK button. 

This command lets you reload emulator configurations that have previously 
been saved. 

Emulator configurations consist of hardware, memory map, and monitor 
settings. 
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Setting the Real-Time Options 

This section shows you how: 

• To allow or deny monitor intrusion 

• To turn polling ON or OFF 

The monitor program is executed by the emulation microprocessor when 
target system memory, memory-mapped I/O, and microprocessor registers 
are displayed or edited. Also, periodic polling to update the Memory, I/O, 
WatchPoint, and Register windows can cause monitor program execution. 

This means that when the user program is running and monitor intrusion is 
allowed, the user program must be temporarily interrupted in order to 
display or edit target system memory, display or edit registers, or update 
window contents. 

If it's important that your program execute without these kinds of 
interruptions, you should deny monitor intrusion. You can still display and 
edit target system memory and microprocessor registers, but you must 
specifically break emulator execution from the user program into the monitor 
first. 

When monitor intrusion is denied, polling to update window contents is 
automatically turned OFF. 

When monitor intrusion is allowed, you can turn polling for particular 
windows OFF to lessen the number of interruptions during user program 
execution. 
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To allow or deny monitor intrusion 

• To deny monitor intrusion, choose the RealTime— >Monitor 
Intrusion— >Disallowed (ALT, R, T, D) command. 

• To allow monitor intrusion, choose the RealTime— >Monitor 
Intrusion— >Allowed (ALT, R, T, A) command. 

When you deny monitor intrusion, any debugger command that may interrupt 
a running user program is prevented. This ensures the user program execute 
in real-time. 

When you allow monitor intrusion, debugger commands that may temporarily 
interrupt user program execution are allowed. 

The current setting is shown by a check mark (V) next to the command. 



To turn polling ON or OFF 

• To turn I/O window polling ON or OFF, choose the RealTime— >I/0 
Polling^ON (ALT, R, I, O) or RealTime^I/O Polling^OFF (ALT, R, 
I, F) command. 

• To turn WatchPoint window polling ON or OFF, choose the 
RealTime^Watchpoint Polling^ON (ALT, R, W, O) or 
RealTime^Watchpoint Polling^OFF (ALT, R, W, F) command. 

• To turn Memory window polling ON or OFF, choose the 
RealTime^Memory Polling^ON (ALT, R, M, O) or 
RealTime->Memory Polling->OFF (ALT, R, M, F) command. 

When the user program is running and monitor intrusion is denied, polling is 
automatically turned OFF. 
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When the user program is running and monitor intrusion is allowed, you can 
turn polling OFF to reduce the number of user program interrupts made in 
order to update I/O, WatchPoint, and Memory window contents. 

The current settings are shown by check marks (V) next to the command. 
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This chapter contains information on loading and debugging programs. 

• Loading and Displaying Programs 

• Displaying Symbol Information 

• Stepping, Running, and Stopping the Program 

• Using Breakpoints and Break Macros 

• Displaying and Editing Variables 

• Displaying and Editing Memory 

• Displaying and Editing I/O locations 

• Displaying and Editing Registers 

• Making Coverage Measurements 

• Tracing Program Execution 

• Setting Up Custom Trace Specifications 
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Loading and Displaying Programs 

This section shows you how: 

• To load user programs 

• To display source code only 

• To display source code mixed with assembly instructions 

• To specify mx flag for assembly instructions 

• To display source files by their names 

• To specify source file directories 

• To search for function names in the source files 

• To search for addresses in the source files 

• To search for strings in the source files 



To load user programs 

1 Choose the File— >Load Object... (ALT, F, L) command. 

2 Select the file to be loaded. 

3 Choose the Load button to load the program. 

With this command, you can load IEEE-695 object file created with any of 
IAR, MRI or Mitsubishi programming tools for M37700. 
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To display source code only 

1 Position the cursor on the starting line to be displayed. 

2 From the Source window control menu, choose the Display— >Source 
Only (ALT, -, D, S) command. 

The Source window may be toggled between the C source only display and 
the C source/mnemonic mixed display. 

The display starts from the line containing the cursor. 

The source only display shows line numbers with the source code. 



To display source code mixed with assembly 
instructions 

1 Position the cursor on the starting line to be displayed. 

2 From the Source window control menu, choose the Display— >Mixed 
Mode (ALT, -, D, M) command. 

The mnemonic display contains the address, data, and disassembled 
instruction mnemonics intermixed with the C source lines. 



104 



Chapter 5: Debugging Programs 
Loading and Displaying Programs 



Example 



C Source/Mnemonic Mode Display 



Filename : c:\hp\rtc\in7700\demo\saiiipleSsample.c 



3 



80066 < 

00080e0 m. . :m : LDA A,03H,S 

00080e2 0x48 PHA 

80067 init_data<>; 

00080e3 0x200880 JSR PG: init_data 

80068 while<l> 

80069 < 

80070 convert <message_id> ; 
00080e6 0xac0620 LDV DT:2006H 
00080e9 0xd8 CLM 

00080ea 0x209480 JSR PG: convert 

80071 message _id = next_nessage<message_id> ; 
00080ed 0xac0620 LDV DT:2006H 

0008 0f0 0x2 He Ii80 JSR PG:next_message 

00080f3 0x8d0620 STA A,DT:2006H 

0008Hf6 0x80ee BRA 0080E6H 



» I J 



See Also 

To specify mx flag for assembly instruction in the "Loading and Displaying 
Programs" section of the "Debugging Programs" chapter. 



To specify mx flag for assembly instructions 

1 Make the Source window the active window. 

2 Specify mxflag to assembly instructions. Choose the 
Display— >Options—>m0x0, Display— >Options—>m0xl, 
Display— >Options—>mlxO or Display— >Options—>mlxl command 
from the Source window's control menu. 

When you display source code mixed with assembly instructions, you need to 
tell the emulator what value of mx flag should be used to disassemble the 
memory contents. This is needed because the length of operand is variable 
according to mx flag. 
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mx flag is automatically set up when the inverse assembler encounters the 
following instructions. 

• SEM 

• CLM 

• SEPX 

• CLPX 

• SEPM 

• CLPM 

Note When you scroll up to see the previous lines of assembly code, top assembly 

line of the Source window may not be accurate. 



To display source files by their names 

1 Make the Source window the active window, and choose the 
Display— >Select Source... (ALT, -, D, L) command from the Source 
window's control menu. 

2 Select the desired file. 

3 Choose the Select button. 

4 Choose the Close button. 

Note The contents of assembly language source files cannot be displayed. 
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To specify source file directories 

1 Make the Source window the active window, and choose the 
Display— ^Select Source... (ALT, -, D, L) command from the Source 
window's control menu. 

2 Choose the Directory... button. 

3 Enter the directory name in the Directory text box. 

4 Choose the Add button. 

5 Choose the Close button to close the Search Directories dialog box. 

6 Choose the Close button to close the Select Source dialog box. 

If the source files associated with the loaded object file are in different 
directories than the object file, you must identify the directories in which the 
source files can be found. 

You can also specify them source file directories by setting the SRCPATH 
environment variable in MS-DOS as follows: 

set SRCPATH=<full path l>;<full path 2> 
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To search for function names in the source files 

1 From the Source window's control menu, choose the 
Search— >Function... (ALT, -, R, F) command. 

2 Select the function to be searched. 

3 Choose the Find button. 

4 Choose the Close button. 

Disassembled instructions are displayed in the Source window for assembly 
language source files. 



To search for addresses in the source files 

1 From the Source window's control menu, choose the 
Search— >Address... (ALT, -, R, A) command. 

2 Type or paste the address into the Address text box. 

3 Choose the Find button. 

4 Choose the Close button. 

Disassembled instructions are displayed in the Source window for assembly 
language source files. 
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To search for strings in the source files 

1 From the Source window's control menu, choose the 
Search— ^String... (ALT, -, R, S) command. 

2 Type or paste the string into the String text box. 

3 Select whether the search should be case sensitive. 

4 Select whether the search should be down (forward) or up 
(backward). 

5 Choose the Find Next button. Repeat this step to search for the next 
occurrence of the string. 

6 Choose the Cancel button to close the dialog box. 
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Displaying Symbol Information 

This section shows you how: 

• To display program module information 

• To display function information 

• To display external symbol information 

• To display local symbol information 

• To display global assembler symbol information 

• To display local assembler symbol information 

• To create a user-defined symbol 

• To display user-defined symbol information 

• To delete a user-defined symbol 

• To display the symbols containing the specified string 
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To display program module information 

• From the Symbol window's control menu, choose the 
Display^Modules (ALT, -, D, M) command. 



To display function information 

• From the Symbol window's control menu, choose the 
Display— >Functions (ALT, -, D, F) command. 

The name, type, and address range for the functions in the program are 
displayed. 



Example Function Information Display 







Symbol 




>- 


Functions 


chanqe status 


int 




0000548. .0000551) 




convert 
convert _case 
in it_data 
main 

next .message 


int 
int 
int 
int 
int 




00004ac. .00005 0f 
0000510. .0000547 
000046a. .00004ab 
000043a.. 0000469 
000055c. .00005 6 f 
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To display external symbol information 

• From the Symbol window's control menu, choose the 
Display— Externals (ALT, -, D, E) command. 

The name, type, and address of the global variables in the program are 
displayed. 



Example External Symbol Information Display 



|;:c Jiari ere _s t at lis 


int <? 




009807* *i 


Iconuert 


MO ill O 






lconvert_case 


void <> 




009803a 


! in it_data 


void <> 






Imain 


void <> 




00980e0 


!next_nessage 


int <> 




00980cb 


1 s anp le Wdat a 


<struct> [] 




0092008 


]san»leSNdata0 


unsigned char 


<*> 


0092000 


9 s anp le Wdat al 


unsigned char 


<*> 


0092002 


1 s anp le Wne s sage _id 


int 




0092006 


s anp le \\s anple _wer 


int 




0092004 
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To display local symbol information 

1 From the Symbol window's control menu, choose the 
Display— >Locals... (ALT, -, D, L) command. 

2 Type or paste the function for which the local variable information is 
to displayed. 

3 Choose the OK button. 

The name, type, and offset from the stack frame of the local variables in the 
selected function are displayed. 



Example 



Local Symbol Information Display 



Symbol 



Locals in convert _case 



"Hlil" 



dat 



<struct> <*> 



unsigned char <*> 
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To display global assembler symbol information 

• From the Symbol window's control menu, choose the Display— >Asm 
Globals (ALT, -, D, G) command. 

The name and address for the global assembler symbols in the program are 
displayed. 



To display local assembler symbol information 

1 From the Symbol window's control menu, choose the Display — >Asm 
Locals... (ALT, -, D, A) command. 

2 Type or paste the module for which the local variable information is 
displayed. 

3 Choose the OK button. 

The name and address for the local assembler variables in the selected 
module are displayed. 



Note The HP 64146/7 emulators do not support this function. UBROF format file 

compiled by IAR compiler does not include assembler local symbol 
information. As the result, you can not see assembler local symbols using 
IEEE-695 file converted from UBROF file. If you need to debug assembler 
local symbols, you need to specify assembler local symbols by using PUBLIC 

directive. In this case, you can see these symbols in global symbols. 



114 



Chapter 5: Debugging Programs 
Displaying Symbol Information 



To create a user-defined symbol 

1 From the Symbol window's control menu, choose the User 
defined— >Add... (ALT, -, U, A) command. 

2 Type the symbol name in the Symbol Name text box. 

3 Type the address in the Address text box. 

4 Choose the OK button. 

User-defined symbols, just as standard symbols, can be used as address 
values when entering commands. 



Example 



To add the user-defined symbol "jmp_start": 




Symbol N 




imp start 



Cancel 



Address: 



jjjelp J 



6aG| 
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To display user-defined symbol information 

• From the Symbol window's control menu, choose the Display— >User 
defined (ALT, -, D, U) command. 

The command displays the name and address for the user-defined symbols. 



Example User-Defined Symbol Information Display 
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To delete a user-defined symbol 

1 From the Symbol window's control menu, choose the Display— >User 
defined (ALT, -, D, U) command to display the user-defined symbols. 

2 Select the user-defined symbol to be deleted. 

3 From the Symbol window's control menu, choose the User 
defined— >Delete (ALT, -, U, D) command. 



To display the symbols containing the specified string 

1 From the Symbol window's control menu, choose the 
FindString^String... (ALT, -, F, S) command. 

2 Type or paste the string in the String text box. The search will be 
case-sensitive. 

3 Choose the OK button. 

To restore the original non-selective display, re-display the symbolic 
information. 
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Stepping, Running, and Stopping the Program 

This section shows you how: 

• To step a single line or instruction 

• To step over a function 

• To step multiple lines or instructions 

• To run the program until the specified line 

• To run the program until the current function return 

• To run the program from a specified address 

• To stop program execution 

• To reset the processor 



To step a single line or instruction 

• Choose the Execution— >Single Step (ALT, E, N) command. 

• Or, press the F2 key. 

In the source display mode, this command executes the C source code line at 
the current program counter address. 

In the source/mnemonic mixed display mode, the command executes the 
microprocessor instruction at the current program counter address. 

Once the source line or instruction has executed, the next program counter 
address highlighted. 
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To step over a function 

• Choose the Execution— >Step Over (ALT, E, O) command. 

• Or, press the F3 key. 

This command steps a single source line or assembly language instruction 
except when the source line contains a function call or the assembly 
instruction makes a subroutine call. In these cases, the entire function or 
subroutine is executed. 



Example When the current program counter is at line 70, choosing the 

Execution— >Step Over (ALT, E, 0) command steps over the "convert" 
function. Once the function has been stepped over, the program counter 
indicates line 71. 





Source 0 




Filename : 


c :\hp\rtc Sm?700\de no \s ample \s ample .c 




I 80066 
B0067 
80068 
#0069 


< 

init_dataO; 
while <1> 

< 




80070 


convert (message _id> ; 




•0071 
80072 
80073 


mess age _id = next_message<message_id> ; 




Hi I 
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To step multiple lines or instructions 

1 Choose the Execution— >Step... (ALT, E, S) command. 

2 Select one of the Current PC, Start Address, or Address options. 
(Enter the starting address when the Address option is selected.) 

3 In the Count text box, type the number of lines to be single-stepped. 

4 Choose the Execute button. 

5 Choose the Close button to close the dialog box. 

The Current PC option starts single -stepping from the current PC address. 
The Start Address option starts single-stepping from the transfer address. 
The Address option starts single-stepping from the address specified in the 
text box. 

In the source only display mode, the command steps the number of C source 
lines specified. In the source/mnemonic mixed display mode, the command 
steps the number of microprocessor instructions specified. 

When the step count specified in the Count text box is 2 or greater, the count 
decrements by one as each line or instruction executes. A count of 1 remains 
in the Count text box. Also, in the Source window, the highlighted line that 
indicates the current program counter moves for each step. 

To step over functions, select the Over check box. 
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To run the program until the specified line 

1 Position the cursor in the Source window on the line that you want to 
run to. 

2 Choose the Execution— >Run to Cursor (ALT, E, C) command. 

Execution stops immediately before the cursor-selected line. 

Because this command uses breakpoints, you cannot use it when programs 
are stored in target system ROM. 

If the specified address is not reached within the number of milliseconds 
specified by StepTimerLen in the B3630.INI file, a dialog box appears, asking 
you to cancel the command by choosing the Stop button. When the Stop 
button is chosen, the program execution stops, the breakpoint is deleted, and 
the processor transfers to the RUNNING IN USER PROGRAM status. 



To run the program until the current function return 

• Choose the Execution— >Run to Caller (ALT, E, T) command. 

The Execution— >Run to Caller (ALT, E, T) command executes the program 
from the current program counter address up to the return from the current 
function. 



Note The debugger cannot properly run to the function return when the current 

program counter is at the first line of the function (immediately after its 
entry point). Before running to the caller, use the Execution-^Single Step 
(ALT, E, N) command to step past the first line of the function. 
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To run the program from a specified address 

1 Choose the Execution— >Run... (ALT, E, R) command. 

2 Select one of the Current PC, Start Address, User Reset, or Address 
options. (Enter the address when the Address option is selected.) 

3 Choose the Run button. 

The Current PC option executes the program from the current program 
counter address. The Start Address option executes the program from the 
transfer address. 

The User Reset option initiates program execution on receiving a RESET 
signal from the target system. The reset wait status can be cleared with the 
Execution— >Reset (ALT, E, E) command. 

The Address option executes the program from the address specified. 



To stop program execution 

• Choose the Execution— >Break (ALT, E, B) command, or press the F4 
key. 

As soon as the Execution— >Break (ALT, E, B) command is chosen, the 
emulator starts running in the monitor. 
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To reset the processor 

• Choose the Execution— >Reset (ALT, E, E) command. 

Once the command has been completed, the processor remains reset. 

If a foreground monitor is selected, it will automatically be loaded when this 
command is executed. This is done to make sure the foreground monitor 
code is intact. 
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Using Breakpoints and Break Macros 

This section shows you how: 

• To set a breakpoint 

• To disable a breakpoint 

• To delete a single breakpoint 

• To list the breakpoints and break macros 

• To set a break macro 

• To delete a single break macro 

A breakpoint is an address you identify in the user program where program 
execution is to stop. Breakpoints let you look at the state of the target 
system at particular points in the program. 

A break macro is a breakpoint followed by any number of macro commands 
(which are the same as command file commands) . 

Because breakpoints are set by replacing opcodes in the program, you cannot 
set breakpoints or break macros in programs stored in target system ROM. 
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To set a breakpoint 

1 Position the cursor on the line where you wish to set a breakpoint. 

2 Choose the Breakpoint— >Set at Cursor (ALT, B, S) command. 

When you run the program and the breakpoint is hit, execution stops 
immediately before the breakpoint line. The current program counter 
location is highlighted. 



Example 



To set a breakpoint at line 43: 





80029 

110030 

80031 

80032 

80033 

80034 

80035 

80036 

80037 

S0038 

80039 

80040 

80041 

80042 

80043 | 

80044 



int 

change_status<int st> 
{ 



> 



< 



Edit... 



Set Macro... 
Delete Macro 



char «nes; 

for<mes = &<dat->message [0 ] > ; *mes •= '\0'; nes»») 
if<*mes >= 'a' && *mes <= 'z'> 

*mes = "lies - 'a' * 'fl'; 
else if<«mes >= 'A' && *mes < = 'Z'> 

*mes = «nes -'fl' ♦ 'a'; 



else 



if<st == ORIGINAL) 



re t urn < CONU ERT ED ) ; 



•uct st_data *dat> 




/* Change status of the messa 



/* Case conuersion 
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To disable a breakpoint 

1 Choose the Breakpoint— >Edit... (ALT, B, E) command. 

2 Select the breakpoint to be disabled. 

3 Select the Disable check box. 

4 To close the dialog box, choose the Close button. 

You can re-enable a breakpoint in the same manner by choosing the 
Breakpoint— >Edit... (ALT, B, E) command, selecting a disabled breakpoint 
from the list, and selecting the Enable/Disable check box. 



To delete a single breakpoint 

• Position the cursor on the line that has the breakpoint to be deleted, 
and choose the Breakpoint— >Delete at Cursor (ALT, B, D) command. 

Or: 

1 Choose the Breakpoint— >Edit... (ALT, B, E) command. 

2 Select the breakpoint to be deleted. 

3 Choose the Delete button. 

4 Choose the Close button. 

The Breakpoint— >Edit... (ALT, B, E) command allows you to delete all the 
breakpoints and break macros at once with the Delete All button. 
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To list the breakpoints and break macros 

• Choose the Breakpoint— >Edit... (ALT, B, E) command. 

The command displays break macros followed by break macro commands in 
parentheses. 

The Breakpoint dialog box also allows you to delete breakpoints and break 
macros. 



To set a break macro 

1 Position the cursor on the line where you wish to set a break macro. 

2 Choose the Breakpoint— >Set Macro... (ALT, B, M) command. 

3 Select Add Macro option. 

4 Specify the macro command in the Macro Command text box. 

5 Choose the Set button. 

6 To add another macro command, repeat steps 4 and 5. 

7 To exit the BreakMacro Entry dialog box, choose the Close button. 

The debugger automatically executes the specified macro commands when 
the break macro line is reached. 

To add macro commands after an existing macro command, position the 
cursor on the macro command before choosing Breakpoint— >Set Macro... 
(ALT, B, M). 



127 



Chapter 5: Debugging Programs 
Using Breakpoints and Break Macros 



To add macro commands to the top of an existing break macro, position the 
cursor on the line that contains the BP marker before choosing 
Breakpoint->Set Macro... (ALT, B, M). 



Example 



To set "EVALUATE" break macros: 

Position the cursor on line 33; then, choose the Breakpoint— >Set Macro. 
(ALT, B, M) command. 

Select Add Macro option. 

Enter "EVALUATE *mes" in the Macro Command text box. 



Breakpoint Edit 



Set" 



Breakpoint Addiess: sample\\tt00033 1 
IE] Add Macro 
Macro Command: 



EVALUATE 



□ Global Disable and Delete All 
Current Breakpoints ~ 



Enable/Disable 



Delete 



Delete 



Close 



JielpJ 



Choose the Set button. 
Choose the Close button. 
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The break macro is displayed in the Source window as shown below. 



Filename : c:\hpSrtcSni7700SdemoSsaiiiple\sample.c 



110029 
80030 
80031 
80032 
80033. 
80033. 
BP 80033 
80034 
80035 
80036 
80037 
80038 
80039 
80040 
80041 
80042 
80043 



conuert_case<struct st_data *dat> ✓* Case conversion 
{ 

char «mes; 

for<nes = &<dat->message [0]> ; «mes •= '\0'; nes++> 

1 EUALUATE *mes 

2 RUN 

if<«tnes >= 'a' && *uies <= 'z'> 

«nes = *mes - ' a' + '()'; 
else if<*mes >= 'A' && «mes <= 'Z'> 

«nies = «mes -'fl' + ' a' ; 



int 

change_status<int st> 

< 

if<st == ORIGINAL) 

return<CONUERIED>; 



/» Change status of the nessa 



To delete a single break macro 

1 Position the cursor on the line that contains the break macro to be 
deleted. 

2 Choose the Breakpoint— >Delete Macro (ALT, B, L) command. 

To delete a single macro command that is part of a break macro, position the 
cursor on the macro command before choosing Breakpoint— ^Delete Macro 
(ALT, B, L). 

The Breakpoint— »Edit... (ALT, B, E) command allows you to delete all the 
breakpoints and break macros at once by choosing the Delete All button. 
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Displaying and Editing Variables 

This section shows you how: 

• To display a variable 

• To edit a variable 

• To monitor a variable in the WatchPoint window 



To display a variable 

1 Position the mouse pointer over the variable in the Source window 
and double-click the left mouse button. 

2 Choose the Variable^Edit... (ALT, V, E) command. 

3 Choose the Update button to read the contents of the variable and 
display the value in the dialog box. 

4 To exit the Variable dialog box, choose the Close button. 

Note that you can update the contents of an auto variable only while the 
program executes within the scope function. 
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To edit a variable 

1 Position the mouse pointer over the variable in the Source window 
and double-click the left mouse button. 

2 Choose the Variable^Edit... (ALT, V, E) command. 

3 Choose the Modify button. This opens the Variable Modify dialog 
box. 

4 Type the desired value in the Value text box. The value must be of 
the type specified in the Type field. 



fSij Variable Modify 


Variable: "mes 

Type: unsigned char 


0, | 
Cancel | 


Value: 41 









5 Choose the OK button. 

6 Choose the Close button. 

Note that you can change the contents of an auto variable only while the 
program executes within the scope function. 
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To monitor a variable in the WatchPoint window 

1 Highlight the variable in the Source window by either double-clicking 
the left mouse button or by holding the left mouse button down and 
dragging the mouse pointer over the variable. 

2 Choose the Variable— >Edit... (ALT, V, E) command. 

3 Choose the "to WP" button. 

4 Choose the Close button. 

5 To open the WatchPoint window, choose the Window— > WatchPoint 
command. 

Note that you can only monitor an auto variable in the WatchPoint window 
when the program executes within the scope function. 
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Displaying and Editing Memory 

This section shows you how: 

• To display memory 

• To display internal RAM and SFR 

• To edit memory 

• To copy memory to a different location 

• To copy target system memory into emulation memory 

• To modify a range of memory with a value 

• To search memory for a value or string 



To display memory 

1 Choose the RealTime^Memory Polling^ON (ALT, R, M, O) 
command. 

2 Choose the Window— >Memory command. 

3 Double-click one of the addresses. 

4 Use the keyboard to enter the address of the memory locations to be 
displayed. 

5 Press the Return key. 

An address may be entered as a value or symbol. You can also select the 
desired address by using the scroll bar. 

To change the size of the data displayed, access the Memory window's 
control menu; then, choose the Display-^Byte (ALT, -, D, Y), Display->16 
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Bits (ALT, -, D, 1), or Display->32 Bits (ALT, -, D, 3) command. When the 
Display— >Byte (ALT, -, D, Y) command is chosen, ASCII values are also 
displayed. 

To specify whether memory is displayed in a single-column or multi-column 
format, access the Memory window's control menu; then, choose the 
Display— ^Linear (ALT, -, D, L) or Display— >Block (ALT, -, D, B) command. 
When the Display— ^Linear (ALT, -, D, L) command is chosen, symbolic 
information associated with an address is also displayed. 

The Memory window display is updated periodically. When the window 
displays the contents of target system memory, user program execution is 
temporarily suspended as the display is updated. To prevent program 
execution from being temporarily suspended (and the Memory window from 
being updated), choose the RealTime-^Monitor Intrusion-^Disallowed (ALT, 
R, T, D) command to activate the real-time mode. 
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Memory Displayed in Byte Format 




♦ 
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To display internal RAM and SFR 

When you don't map internal RAM (or SFR) as emulation RAM: 

- Choose the Window— ^Memory command. 

- Double-click one of the addresses. 

- Use the keyboard to enter the address of internal RAM (or SFR) 
to be displayed. 

- Press the Return key. 

Displaying internal RAM (or SFR) addresses accesses internal memory of the 
emulation processor. Therefore, the emulator breaks to the monitor to read 
the contents of memory. As the result, user program execution is suspended 
to display this memory. 

When you map internal RAM (or SFR) as emulation RAM: 

- Choose the Window— ^Memory command. 

- Double-click one of the addresses. 

- Use the keyboard to enter the address of internal RAM (or SFR) 
to be displayed. 

- Press the Return key. 

When you map internal RAM (or SFR) as emulation RAM, the emulator 
writes data to both internal RAM (or SFR) and emulation memory. In this 
case, you can see the data written to emulation memory without suspending 
program execution. 

When you map internal RAM (or SFR) as emulation RAM, you can still 
display the contents of internal RAM (or SFR) by using the following 
procedure. 

- Choose the Window-H>Memory command. 

- Double-click one of the addresses. 

- Specify the address of internal RAM (or SFR) with "@i". 

- Press the Return key. 
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Note The contents of emulation memory is updated only when user program writes 

data to internal RAM or SFR. Therefore, the contents of emulation memory 
may be different from the actual value of internal RAM or SFR. Especially, 
you should pay close attention when setting the flags of SFR. 



Note When you modify memory, the emulator breaks to the monitor, and writes 

data to internal RAM or SFR. Therefore, user program execution is 
suspended when modifying internal RAM and SFR. 



Note When you direct the emulator to display the contents of internal RAM (or 

SFR), the emulator can display only internal RAM (or SFR) area. You can't 
see and scroll-down to the other memory areas (emulation memory or target 
memory) from internal RAM (or SFR) areas. 



Example When you map internal RAM as emulation RAM, you can enter both of the 

following address values to display the contents of address 100 hex: 

100 Accesses emulation RAM without suspending user 

program execution. 

100@i Accesses internal RAM of emulation processor, and 

suspends user program execution. 

See Also 

To map internal RAM and SFR in the "Mapping Memory" Section of the 
"Configuring the Emulator" chapter. 
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To edit memory 

Assuming the location you wish to edit has already been displayed (and 
Memory window polling is turned ON): 

1 Double-click the location you wish to edit. 

2 Use the keyboard to enter a new value. 

3 Press the Return key. Notice that the next location is highlighted. 

4 Repeat steps 2 and 3 to edit successive locations. 

Editing the contents of target system memory causes user program execution 
to be temporarily interrupted. You cannot modify the contents of target 
memory when the emulator is running the user program and monitor 
intrusion is disallowed. 
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To copy memory to a different location 

1 From the Memory window's control menu, choose the 
Utilities— >Copy... (ALT, -, U, C) command. 

2 Enter the starting address of the range to be copied in the Start text 
box. 

3 Enter the end address of the range to be copied in the End text box. 

4 Enter the address of the destination in the Destination text box. 

5 Choose the Execute button. 

6 To close the Memory Copy dialog box, choose the Close button. 
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To copy target system memory into emulation 
memory 

1 Map the address range to be copied as emulation memory. 

2 Because the processor cannot read target system memory when it is 
in the EMULATION RESET state, choose the Execution->Break 
(ALT, E, B) command, or press the F4 key, to break execution into 
the monitor. 

3 From the Memory window's control menu, choose the 
Utilities— >Image... (ALT, -, U, I) command. 

4 Enter the starting address in the Start text box. 

5 Enter the end address in the End text box. 

6 Choose the Execute button. 

7 To exit the Memory Image Copy dialog box, choose the Close button. 

This command is used to gain access to features that are only available with 
emulation memory (like breakpoints). 

The following commands cannot be used when programs are stored in target 
system ROM. However, you can use these commands if you copy the 
contents of target system ROM into emulation memory with the 
Utilities— >Image... (ALT, -, U, I) command: 

Breakpoint-»Set at Cursor (ALT, B, S) 
Breakpoint-^Delete at Cursor (ALT, B, D) 
Breakpoint^Set Macro... (ALT, B, M) 
Breakpoint-^Delete Macro (ALT, B, L) 
Execution->Run to Cursor (ALT, E, C) 
Execution->Run to Caller (ALT, E, T) 
Settings->Coverage->Coverage ON (ALT, S, V, O) 
Settings->Coverage->Coverage Reset (ALT, S, V, R) 
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Example To copy the contents of addresses Oh through Offfh from target system 

memory to the corresponding emulation memory address range: 





Memory Image 










Start: 


0 


° K 1 


End: 


Offf 


Close | 


Size: 


<S> byte O 16 Bits 











To modify a range of memory with a value 

1 From the Memory window's control menu, choose the 
Utilities->Fill... (ALT, -, U, F) command. 

2 Enter the desired value in the Value text box. 

3 Enter the starting address of the memory range in the Start text box. 

4 Enter the end address in the End text box. 

5 Select one of the Size options. 

6 Choose the Execute button. 

The Byte or 16 Bit size option specifies the size of the values that are used to 
fill memory. 
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To search memory for a value or string 

1 From the Memory window's control menu, choose the Search... (ALT, 
-, R) command. 

2 Enter in the Value or String text box the value or string to search for. 

3 Enter the starting address in the Start text box. 

4 Enter the end address in the End text box. 

5 Choose the Execute button. 

6 Choose the Close button. 

When the specified data is found, the location at which the value or string 
was found is displayed in the Memory window. 



Example 



To search addresses 2000h through Offffh, for the string "This": 



Search Memory 



Value: 
String: 
Start: 
End: 



Search 



This 



2000 



Close 



.....] 



Offff 



Help \ 



Size: <§) byte O 16 Bits 
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Displaying and Editing I/O Locations 

This section shows you how: 

• To display I/O locations 

• To edit an I/O location 

With the M3770 microprocessor, I/O locations are memory-mapped. 



To display I/O locations 

1 Choose the Window— >I/0 command. 

2 From the I/O window's control menu, choose the Define... (ALT, -, D) 
command. 

3 Enter the address in the Address text box. 

4 Select whether the size of the I/O location is a Byte or 16 Bits. 

5 Choose the Set button. 

6 Choose the Close button. 

The Window->I/0 command displays the contents of the specified I/O 
locations. 

The debugger periodically reads the I/O locations and displays the latest 
status in the I/O window. To prevent the debugger from reading the I/O 
locations (and updating the I/O window), choose the RealTime— >I/0 
Polling^OFF (ALT, R, I, F) command. 
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Example To display the contents of address 2000: 



I/O Setting 



"Set 

Addiess: 2000 | 
Size: <f> byte O 16 Bits 

Space: •Men, I SeT 



'WO set 


Close J 
I Help 1 




addiess: 0002000. size: byte 








Delete ] 





To edit an I/O location 

1 Display the I/O value to be changed with the Window— >I/0 command. 

2 Double-click the value to be changed. 

3 Use the keyboard to enter a new value. 

4 Press the Return key. 

To confirm the modified values, press the Return key for every changed value. 

Editing the I/O locations temporarily halts user program execution. You 
cannot modify I/O locations while the user program executes in the real-time 
mode or when I/O polling is turned OFF. 
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Displaying and Editing Registers 

This section shows you how: 

• To display registers 

• To edit registers 



To display registers 

• Choose the Window— >Register command. 

The register values displayed in the window are periodically updated to show 
you how the values change during program execution. The decoded flag 
register flags allow you to identify the register status at a glance. 

When the Register window is updated, user program execution is temporarily 
interrupted. To prevent the user program from being interrupted (and the 
Register window from being updated), choose the RealTime— ^Monitor 
Intrusion— ^Disallowed (ALT, R, T, D) command to activate the real-time 
mode. 



Example 



Register Contents Displayed in the Register Window 



Basic Registers 



A 


=205C 


B 


=0000 


X 


=0000 


y 


=0000 


SP 


=2251 


DT 


=00 


PG 


=00 


PC 


=80D1 


DPR 


=205C 


PS 


=0004 


! i 





w 

A I 
B 



NAME UALUE DESCRIPTION 



Accumulator 
Accumulator 
Index X 
Index V 
Stack Pointer 
Data Bank 
Program Bank 
Program Counter 
Direct Page 
Processor Status 
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To edit registers 

1 Display the register contents by choosing the Window— >Basic 
Registers command. 

2 Double-click the value to be changed. 

3 Use the keyboard to enter a new value. 

4 Press the Return key. 

Modifying register contents temporarily interrupts program execution. You 
cannot modify register contents while the user program is running and 
monitor intrusion is disallowed. 

Note that register values are not actually changed until the Return key is 
pressed. 

Double-clicking registers with flags or other bit fields opens the Register Bit 
Fields dialog box which you can use to set or clear individual bit fields. 
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Making Coverage Measurements 

This section shows you how: 

• To display execution coverage 



To display execution coverage 

1 Choose the Settings->Coverage^Coverage Reset (ALT, S, V, R) 
command. 

2 Execute the user program. 

3 Choose the Settings^Coverage^Coverage ON (ALT, S, V, O) 
command. 

This command checks and displays the program execution coverage. The 
coverage display highlights the statements fetched since the last coverage 
reset. 

If you display execution coverage without resetting the previous execution 
coverage, the measurement will not be correct. 

In addition, execution coverage can only be displayed only for programs 
stored in emulation memory. To display execution coverage for programs 
stored in target system memory, first transfer the program into emulation 
memory. 

To hide the execution coverage data, choose the 
Settings->Coverage->Coverage OFF (ALT, S, V, F) command. 



Note The coverage display also highlights a source symbol when the source symbol 

corresponds to a single assembly language instruction and the instruction is 
prefetched. 
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Example Execution Coverage Displayed in Source Window 





Source QS 


Filename : 


c :\hp\i*tc\ii7700\deno\saiiple\sanple . c 


i i ■ • -om 




#0058 
#0059 


if<id == MESSAGED 

return<MESSflGE2>: 


#0060 
#0061 


else 

return <MESSAGE1 > ; 




1 #0062 > 




80063 
#0064 
#0065 


uoid 

main(uoid) 




| #0066 
#0067 


< ■ 
initdataO; 


#0068 
#0069 


while <1> 




#0070 
#0071 


convert <message_id> ; fR 
nessacie^id = next_jnessacfe<nessa«e_id> ; Wm 


#0072 
#0073 
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Tracing Program Execution 

This section shows you how: 

• To trace function flow 

• To trace callers of a specified function 

• To trace execution within a specified function 

• To trace accesses to a specified variable 

• To trace before a particular variable value and break 

• To trace until the command is halted 

• To stop a running trace 

• To repeat the last trace 

• To identify bus arbitration cycles in the trace 

• To display bus cycles 

• To display accumulated or relative counts 



How the Analyzer Works 

When you trace program execution, the analyzer captures microprocessor 
address bus, data bus, and control signal values at each clock cycle. The 
values captured for one clock cycle are collectively called a state. A trace is a 
collection of these states stored in analyzer memory (also called trace 
memory). 

The trigger condition tells the analyzer when to store states in trace memory. 
The trigger position specifies whether states are stored before, after, or about 
the state that satisfies the trigger condition. 

The store condition limits the kinds of states that are stored in trace memory. 

When the states stored are limited by the store condition, up to two states 
which satisfy the prestore condition may be stored when they occur before 
the states that satisfy the store condition. 
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After a captured state satisfies the trigger condition, a trace becomes 
complete when trace memory is filled with states that satisfy the store and 
prestore conditions. 

Trace Window Contents 

When traces are completed, the Trace window is automatically opened to 
display the trace results. 

Each line in the trace shows the trace buffer state number, the type of state, 
the module name and line number, the function name, the source file 
information, and the time information for the state (relative to the other 
lines, by default). 

When bus cycles are included, the address, data, and disassembled 
instruction or bus cycle status mnemonics are shown. 



Note Read data from the internal RAM or SFR is not traced correctly by the 

emulation analyzer. 



Note Write data is not traced correctly, when the following conditions are met 

• The emulator is used with the M37780/81/82/83/85/95/96 emulation 
pods. 

• The processor is operating in the memory expansion or 
microprocessor mode with 8 bit external bus. 
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To trace function flow 



• Choose the Trace— >Function Flow (ALT, T, F) command. 

The command stores function entry points, and the resulting trace shows 
program execution flow. 

The command traces C function entry points only. It does not trace 
execution for assembly language routines. 



Note When you compile empty functions using icc7700 or nc77, stack frame is not 
made and you can't trace function flow correctly. 



Example Function Flow Trace 







Trace - Loading Data ( Frz 


ime: 1) 








state 


typ 


moduleWttline 


function 


source 






>> 


1 2 


SEQ 


sample\\80038 


:convert 


< 


1.200 


uS~TG 


♦ 


6 


SEQ 


samp le\\80044 


: conuert_case 


< 


14.40 


uS 




12 


SEQ 


sample W80054 


: change _statu 


< 


232.4 


uS 




20 


SEQ 


sample\\«0062 


:next _inessage 


< 


27.60 


uS 




24 


SEQ 


sanple\\»0038 


:convert 


< 


17.00 


uS 




28 


SEQ 


sample\\80044 


:conuert_case 


< 


14.40 


uS 




34 


SEQ 


sanple\\tt0054 


change_statu 


< 


323.1 


uS 




42 


SEQ 


sanple\\tt0062 


:next_inessage 


< 


26.80 


uS 




46 


SEQ 


san>ple\\»0038 


:convert 


< 


16.20 


uS 




50 


SEQ 


sample\\tt0044 


:conMert_case 


< 


14.40 


uS 




56 


SEQ 


sampleS\H0054 


: change _statu 


< 


254.0 


uS 




64 


SEQ 


sample\\tt0062 


:next_message 


t 


26.80 


uS 




68 


SEQ 


sainple\\»0038 


^convert 


< 


17.00 


uS 




72 


SEQ 


sample\\tt0044 


: convert_case 


< 


14.40 


uS 
















mama 


♦j 
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To trace callers of a specified function 

1 Double-click the function name in one of the debugger windows. 

2 Choose the Trace— >Function Caller... (ALT, T, C) command. 

3 Choose the OK button. 

This command stores the first executable statement of the specified function 
and prestores statements that execute before it. The prestored statements 
show the caller of the function. 

To identify interrupts in program execution, trace the caller of the interrupt 
process routine using the Trace-^Function Caller... (ALT, T, C) command. 

For Assembler symbols, the system traces the last two instructions executed 
before the specified Assembler symbol is reached. Specifying the first 
symbol of a subroutine enables the system to trace the caller of the 
subroutine. 
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Example 



To trace the caller of "next_message": 
Double-click "next_message". 

Choose the Trace— ^Function Caller... (ALT, T, C) command. 



RealTime C Debugger 
Irace 



File Execution Breakpoint Variable BGSEJ RealTime Assemble... Settings 
Window Help | Function Flow 



Filename : 


c :\hpSrtc\nT7700\demo^ 


80040 
80041 


change_status<int 


80042 


if<st == ORIG] 


80043 


return <COI 


80044 


else 


80045 


return<OR: 


80046 
80047 


> 


80048 


uoid 


80049 


conuert<int id> / 


80050 


< 


8005 1 


convert _case<< 


80052 


data [id] .stati 


80053 


> 


80054 




80055 


int 


80056 





Function Caller.. 



Function Statement.. 
Variable Access... 
Variable Break... 
Edit... 



Trigger Store... 
Find Then Triggi 
Sequence... 



Until Halt 
Halt 



Ctl+F7 
F7 



/« Change message to be conver 




The Trace window becomes active and displays the trace results. 



Trace - Loading Data ( Frame: 1) 



state typ module Wttline 



| 2 PRE sanple\\80071 
3 sanple\\tt0057 

5 PRE sanpleS\80071 

6 sanple\\«0057 

8 PRE sanple\\l*0071 

9 sanple\\tt0057 

11 PRE sanpleS\#0071 

12 sanple\\tt0057 

14 PRE sanple\\tt0071 

15 sanple\\tt0057 

17 PRE sanpleS\#0071 

18 sanple\\tt0057 

20 PRE sanpleS\»0071 

21 sanple\\«00S7 



function 



nam 

next_nessage < 
nain 

next__nessage < 
nain 

next_nessage < 
nain 

next_nessage < 
nain 

next_nessage < 
nain 

next_nessage < 
nain 

next_nessage { 



nessag 
nessag 
nessag 
nessag 
nessag 
nessag 
nessag 



prestore "TG 
306.4 uS 
prestore 
405.9 uS 
prestore 
505.4 uS 
prestore 
363.2 uS 
prestore 
460.6 uS 
prestore 
405.9 uS 
prestore 
505.4 uS 



You can see how prefetching affects tracing by choosing the Display— >Bus 
Cycle ON (ALT, -, D, B) command from the Trace window's control menu. 
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To trace execution within a specified function 

1 Double-click the function name in the Source window. 

2 Choose the Trace— >Function Statement... (ALT, T, S) command. 

This command traces C functions only. It does not trace execution of 
assembly language subroutines. 



Example 



To trace execution within "next_message": 
Double-click "next_message". 

Choose the Trace— ^Function Statement... (ALT, T, S) command. 



File Execution Breakpoint Variable 
Window Help 



RealTime C Debugger 
Trace 



RealTime Assemble... Settings 



Filename : 


c :\hp\rtc\m77B0\demov 


80040 


change_status<int 


80041 


< 


80042 


if<st == 0RIG1 


80043 


return<COI 


80044 


else 


80045 


return<OR] 


80046 


> 


80047 




80048 


void 


80049 


conuertCint id) / 


80050 


{ 


80051 


convert _case<c 


80052 


data [id] .stati 


80053 


> 


80054 




80055 


int 


80056 





Function Flow 
Function Caller. 



Function Statement.. 



Variable Access.. 
Variable Break... 
Edit... 




Trigger Store... 
Find Then Trigger.. 
Seguence... 



Until Halt 
Halt 
Again 



Ctl+F7 
F7 

yu.iitaiUK'.uai.dL.LUJ 'status); 



the 



Change nessage to be conver 



The Trace window becomes active and displays the results. You can see how 
prefetching affects tracing by choosing the Display->Bus Cycle ON (ALT, -, 
D, B) command from the Trace window's control menu. 
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To trace accesses to a specified variable 

1 Double-click the global variable name in the Source window. 

2 Choose the Trace— > Variable Access... (ALT, T, V) command. 

The command also traces access to the Assembler symbol specified by its 
name and size. 



Example 



To trace access to "message_id": 
Double-click "message_id". 

Choose the Trace— ^Variable Access... (ALT, T, V) command. 




RealTime C Debugger 
Trace 



File Execution Breakpoint Variable 

Window Help | Function Flow 

Function Caller... 
Function Statement.. 



RealTime Assemble... Settings 



Filenane : c :\hp\rtc\m7700\demo s 



110056 
tt0057 
80058 
80059 
80060 
80061 
80062 
80063 
80064 
80065 
80066 
80067 
80068 
80069 
80070 
80071 



int 

next_nessage < int 

< 

if<id == MESS! 
return <MEJ 

else 

return<HE! 

> 

uoid 

main(uoid> 

< 

in it_data<> ; 
uhile<l> 
< 



Variable Access.. 



Variable Break... 
Edit... 



Irigger Store... 
Find Then Trigger.. 
Sequence... 



Until Halt 

Halt 

Again 



convert <mes saqe_id> ; 

uEH^T ff iMM = next_nessage<message_id>; 




The Trace window becomes active and displays the trace results. 
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To trace before a particular variable value and break 

1 Double-click the desired global variable. 

2 Choose the Trace— > Variable Break... (ALT, T, B) command. 

3 Enter the value in the Value text box. 

4 Choose the OK button. 

The Trace— > Variable Break... (ALT, T, B) command breaks execution as soon 
as the specified value is written to the specified global variable. 

The command also breaks execution at the Assembler symbol specified by its 
name and size. 
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Example 



To break execution as soon as "message_id" contains "0": 
Double-click "message_id". 

Choose the Trace— > Variable Break... (ALT, T, B) command. 



File Execution 
Window Help 



Breakpoint Variable 



RealTime C Debugger 
Trace 



Assemble... Settings 



HUM',', 
80056 
tt0057 
80058 
80059 



80061 
80062 
80063 
80064 
80065 
80066 
80067 
80068 
80069 
80070 
80071 



int 

n e xt _me s s age < in t 

if<id == NESSf 
re t urn < ME! 

else 

return<ME: 

> 



Function Flow 
Function Caller... 
Function Statement... 
Variable Access... 



Variable Break.. 



void 

main<uoid> 
< 

init_dataO ; 
uhile<l) 



Edit.. 



Irigger Store... 
Find Then Trigger., 
jj Seguence... 



Until Halt 

Halt 

Again 




Ctl+F7 
F7 



be conuer 



convert <ne ssage_id> ; 

uTSSSfSCT Mtfl = next_nessage (dies s a«je_ i <1 ) ; 



Enter "0" in the Value text box. 



Variable Break Trace 



Variable: 



message_id 



Cancel 



Value: 



Help 



Choose the OK button. 



The debugger halts execution as soon as the program writes "0" to the 
"message_id" variable. Once execution has halted, the Trace window 
becomes active and displays the results. 
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To trace until the command is halted 

1 To start the trace, choose the Trace^Until Halt (ALT, T, U) 
command. 

2 When you are ready to stop the trace, choose the Trace— >Halt (ALT, 
T, H) command. 

This command is useful, for example, in tracing program execution that leads 
to a processor halted state or to a break to the monitor. 



To stop a running trace 

• Choose the Trace— >Halt (ALT, T, H) command. 

The command is used to: 

Stop the trace initiated with the Trace— >Until Halt (ALT, T, U) command. 

Force termination of the trace that cannot be completed due to absence 
of the specified state. 

Stop a trace before the trace buffer becomes full. 



To repeat the last trace 

• Choose the Trace— >Again (ALT, T, A) command, or press the F7 key. 

The Trace— >Again (ALT, T, A) command traces program execution using the 
last trace specification stored in the HP 64700. 
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To display bus cycles 

1 Place the cursor on the line from which you wish to display the bus 
cycles. 

2 From the Trace window's control menu, choose the Display— >Bus 
Cycle ON (ALT, -, D, B) command. 

The Display— >Bus Cycle ON (ALT, -, D, B) command displays the bus cycles 
associated with each of the source lines. 

The display starts from the cursor-selected line. 

To hide the bus cycles, choose the Display— ^Source Only (ALT, -, D, S) 
command from the Trace window's control menu. 



Example Bus Cycles Displayed in Trace 



— i ^1 




Trace - Loading Data ( Frame: 1] 










state typ 


noduleWttline 


:function source 








>>! 


1 


sample\\l*0066 


:main < 


0.120 


LlS 


A 


1 


0008 0e0 


xxa3 


LDA R.03H.S 


0.120 


uS 




2 


00080e2 


2048 


fetch 


0.280 


uS 




3 


000225a 


205c 


cpu read 


0.360 


uS 




4 


0008 0e2 


xx5c 


PHfl 


0.120 


uS 




5 


00080e4 


8008 


fetch 


0.400 


uS 






sample\\tt0067 


:main init_data<); 


1.400 


uS 




6 


00080e3 


xx5c 


JSR PG:init_data 


0.240 


uS 




7 


0002256 


205c 


cpu write 


0.120 


uS 




8 


00080e6 


06 ac 


fetch 


0.360 


uS 




9 


0002254 


80e6 


cpu write 


0.400 


uS 




10 


0008008 


03 a3 


fetch 


0.360 


uS 






sanpleS\»0019 


: in it data < 


1.360 


uS 




11 


0008008 


xxa3 


LDR A.03H.S 


0.120 


uS 




*l, J 












J* 


* 1 
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To display accumulated or relative counts 

• From the Trace window's control menu, choose the 
Display^Count^Absolute (ALT, -, D, C, A) or 
Display— >Count—>Relative (ALT, -, D, C, R) command. 

Choosing the Display— >Count— ^Relative (ALT, -, D, C, R) command selects 
the relative mode where the state-to-state time intervals are displayed. 

Choosing the Display— »Count—>Absolute (ALT, -, D, C, A) command selects 
the absolute mode where the trace time is displayed as the total time elapsed 
since the analyzer has been triggered. 
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Setting Up Custom Trace Specifications 

This section shows you how: 

• To set up a "Trigger Store" trace specification 

• To set up a "Find Then Trigger" trace specification 

• To set up a "Sequence" trace specification 

• To edit a trace specification 

• To trace "windows" of program execution 

• To store the current trace specification 

• To load a stored trace specification 



Note Analyzer memory is unloaded two states at a time. If you use a storage 

qualifier to capture states that do not occur often, it's possible that one of 
these states has been captured and stored but cannot be displayed because 
another state must be stored before the pair can be unloaded. When this 
happens, you can stop the trace measurement to see all stored states. 



When Do I Use the Different Types of Trace Specifications? 

When you wish to trigger the analyzer on the occurrence of one state, use the 
"Trigger Store" dialog box to set up the trace specification. 

When you wish to trigger the analyzer on the occurrence of one state 
followed by another state, or one state followed by another state but only 
when that state occurs before a third state, use the "Find Then Trigger" 
dialog box to set up the trace specification. 

When you wish to trigger the analyzer on a sequence of more than two states, 
use the "Sequence" dialog box to set up the trace specification. 
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To set up a "Trigger Store" trace specification 



1 Choose the Trace^Trigger Store... (ALT, T, T) command. 



2 Specify the trigger condition using the Address, Data, and/or Status 
text boxes within the Trigger group box. 



3 Specify the trigger position by selecting the trigger start, trigger 
center, or trigger end option in the Trigger group box. 



4 Specify the store condition using the Address, Data, and/or Status 
text boxes within the Store group box. 



5 Choose the OK button to set up the analyzer and start the trace. 



The Trace->Trigger Store... (ALT, T, T) command opens the Trigger Store 
Trace dialog box: 



Trigger Store Trace 



Tiiggei 

QnotI 



Addiess 



Data 



Status 



End Addiess 



tiiggei stall O trigger center U trigger end 



Store 








□ NOT 


Address 


Data 


Status 






I 




End Address 







Cancel 



Clear 



Load.. 



Save... i 

flflflflMV'^ 1 1 ■■"■■■■■■■■■■■ L J 



Help j 



A group of Address, Data, and Status text boxes combine to form a state 
qualifier. You can specify an address range by entering a value in the End 
Address box. By selecting the NOT check box, you can specify all states 
other than those identified by the address, data, and status values. 
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Example 



To trace execution after the "convert_case" function: 

Choose the Trace->Trigger Store... (ALT, T, T) command. 

Enter "convert_case" in the Address text box in the Trigger group box. 



Trigger Store Trace 



Trigger 
□ NOT 



Address 



Data 



Status 



conveit_casej 



End Addiess 



® trigger start O trigger center O trigger end 



r Store 
□ NOT 



Addiess 



Data 



Status 



End Address 



° K 1 



Cancel I 



Clear 



_Load___J 



S_ave... | 



Help 1 



Choose the OK button. 



Example 



To trace execution before and after the "convert_case" function and store 
only states with "write" status: 



Trigger Store Trace 



Trigger 
□ NOT 



Address 



Data 



Status 



convert case 



End Address 



o trigger start trigger center O trigger end 



r Store 
□ NOT 



Addiess 



Data 



Status 



End Address 



a 



Cancel 



Clear 



^ I 



Save. 



Help 
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Example 



To specify the trigger condition as any address in the range lOOOh through 
lfffh: 



Trigger Store Trace 



Trigger 
□ NOT 



Address 



Data 



Status 



1000 



End Address 



Ifffj 



trigger start 



o trigger center O trigger end 



"Store 
□ NOT 



Address 



End Address 



Data 



Status 



OK 



Cancel 



Clear 



Load.. 



Save. 



Help 
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To set up a "Find Then Trigger" trace specification 

1 Choose the Trace^Find Then Trigger... (ALT, T, D) command. 

2 Specify the sequence, which is made up of the enable, trigger store, 
trigger, and store conditions. 

3 Specify the restart, count, and prestore conditions. 

4 Specify the trigger position by selecting the trigger start, trigger 
center, or trigger end option. 

5 If you want emulator execution to break to the monitor when the 
trigger condition occurs, select the Break On Trigger check box. 

6 Choose the OK button to set up the analyzer and start the trace. 



The Trace— >Find Then Trigger... (ALT, T, D) command opens the Find Then 
Trigger Trace dialog box: 



Sequence 
Enable Stoie: 

Enable: 
Trigger Store: 

Trigger: 
Store: 



Find then Trigger Trace 



any state 



any state 



any state 



any state 



Restart: 

Count: 

Prestore: 



no state 



time 



no state 



(•> trigger start 
O trigger center 
O trigger end 
Q Break on Trigger 



OK 



Cancel 



Clear 



Load... 



Save.. 



Pattern/Range: (Select with:Return/DblClick) 


Help 




a = A: D: S: 




*\ 


b = A: D: S: 






c = A: D: S: 






d = A: D: S: 






e = A: D: S: 




*\ 



Choosing the enable, trigger, store, count, or prestore buttons opens a 
Condition dialog box that lets you select "any state", "no state", trace patterns 
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"a" through "h", "range", or "arm" as the condition. Patterns "a" through "h", 
"range", and "arm" are grouped into two sets, and resources within a set may 
be combined using the "or" or "nor" logical operators. Resources from the two 
sets may be combined using the OR or AND logical operators. 



Trace Condition 



any state 



O no state 



state " 
set! 



□ a Db Dc 
IZI d CH range 

□ not range 

O or O nor 



□ OR 

□ and 



r set2 

□ e Ut Dg 

□ h Darm 

O or O nor 



Count 



OK 



Cancel! 



Jielp | 



The range and pattern resources are defined by double-clicking on the 
resource name in the Pattern/Range list box. 

If you double-click on a pattern name, the Trace Pattern dialog box is opened 
to let you specify address, data, and status values. By selecting the NOT 
check box, you can specify all states other than those identified by the 
address, data, and status values. The Direct check box lets you specify 
status values other than those that have been predefined. 



□ not 



Address: 
Data: 



□ Direct.: 



Trace Pattern 



□ K 



Cancel j 



Status: 


bg 


dmawiite word 


byte 


exec write 


cpu 


fetch 


data 


fg 


dataread 


hold 


datawrite 


mx 


dma 


read 


dmaread 


ref 



flea, | 



Help 
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If you double-click on the range resource, the Trace Range dialog box is 
opened to let you select either the Address range or the Data range option 
and enter the minimum and maximum values in the range. 




Example 



To trace execution after the "convert_case" function: 
Choose the Trace— >Find Then Trigger... (ALT, T, D) command. 
Choose the Trigger button (default: any state). 
Select "a". 



Trace Condition 



D any state D no state 



state 

rseti 

Hijg □ b □ c 
Q d Q range 
not range 

<§> 01 O nor 



□ OR 

□ and 



"set2 

□ e Df Da 

□ h □ arm 
O 01 O noi 



Count 



□K 



Cancel 



Help | 



Choose the OK button. 

Double-click "a" in the Pattern/Range list box. 
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Enter "convert_case" in the Address text box in the Trace Pattern dialog box. 



Trace Pattern 



□ NOT 

Address: 

Data: 

Status: 



□ Direct: 



OK 



convert_case 



Cancel 9 

V.Y.V^.V^.Y.V.V. , .V. , . , .-. , . , ..-. , . , .-. , .J 



Clear 



bg 


dmawrite 


word 


byte 


exec 


write 


cpu 


fetch 




data 


fg 




dataread 


hold 




datawrite 


mx 




dma 


read 




dmaread 


ref 





Help 



Choose the OK button in the Trace Pattern dialog box. 



ind then Trigger Trace 



Sequence 
Enable Store: 

Enable: 
I rigger Store: 

Trigger: 
Store: 



any state 



any state 



any state 



axl 



any state 



Restart: 

Count: 

Prestore: 



no state 



time 



no state 



<•) trigger start 
O trigger center 
O trigger end 
CD Break on Trigger 



Pattern/Range: (Select withRetum/DblClick) 



a = A:convert_case D: S: 

b = A: D: S: 

c = A: D: S 

d = A: D: S 

e = A: D: S 



□ K 



Cancel J 



Clear 



Save.. 



Help 



Choose the OK button in the Find Then Trigger Trace dialog box. 
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Example 



To trace about the "next_message" function when it follows the 
"change_status" function and store all states after the "change_status" 
function: 



"Sequence 



Find then Trigger Trace 



Enable Store: 


ino state] | 


Enable: 


I 


Trigger Store: 


any state | 


Trigger: 


hxl 1 


Store: 


any state j 



Restart: 

Count: 

Prestore: 

c 



no state 



no state 



Pattern/Range: (Select with:Return/DblClick) 



trigger start 
® trigger center 
O trigger end 
□ Break on Trigger 



OK 



Cancel 



Clear 



Load 



Save... | 



A:change_status D: S: 
b = A: next message D: S: 
c = A: D: S: 
d = A: D: S: 
e = A: D: S: 



To set up a "Sequence" trace specification 

Sequence trace specifications let you trigger the analyzer on a sequence of 
several captured states. 

There are 8 sequence levels. When a trace is started, the first sequence level 
is active. Entry into one of the other sequence levels (you specify which) will 
trigger the analyzer. Each level lets you specify two conditions that, when 
satisfied by a captured state, will cause branches to other levels: 

if (state matches primary branch condition) 

then GOTO (level associated with primary branch) 

else if (state matches secondary branch condition) 

then GOTO (level associated with secondary branch) 

else 

stay at current level 
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1 Choose the Trace— >Sequence... (ALT, T, Q) command. 

2 Specify the primary branch, secondary branch, and store conditions 
for each sequence level you will use. 

3 Specify which sequence level to trigger on. The analyzer triggers on 
the entry to the specified level. Therefore, the condition that causes 
a branch to the specified level actually triggers the analyzer. 

4 Specify the count and prestore conditions. 

5 Specify the trigger position by selecting the trigger start, trigger 
center, or trigger end option. 

6 If you want emulator execution to break to the monitor when the 
trigger condition occurs, select the Break On Trigger check box. 

7 Choose the OK button to set up the analyzer and start the trace. 

The Trace— ^Sequence... (ALT, T, Q) command calls the Sequence Trace 
Setting dialog box, where you make the following trace specifications: 



Sequence Trace 



Sequence 





Primary 
Branch: 


to 


Secondary 
Branch: 


to 


1 


any state 




no state | 1 J 


2 


any state 


hi 


no state | 1 J 


3 


any state 


hi 


no state | 1 j 


4 


any state 


hi 


no state | 1 | 



Page 



Store: 



any state 



any state 



any state 



time 



Trigger On: 
Count: 
Prestore: 

<S> trigger start 
O trigger center 
O trigger end 
□ Break on Trigger 



Pattern/Range: (Select witlr Retum/DblClick) 



OK 



~1 | Ca ncel j 



] | Pear | 



Load.. 



Save.. 



a = A: D: S: 

b = A: D: S: 

c = A: D: S: 

d = A D: S: 

e = A D: S: 



Help 



Choosing the primary branch, secondary branch, store, count, or prestore 
buttons opens a Condition dialog box that lets you select "any state", "no 
state", trace patterns "a" through "h", "range", or "arm" as the condition. 
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Patterns "a" through "h", "range", and "arm" are grouped into two sets, and 
resources within a set may be combined using the "or" or "nor" logical 
operators. Resources in the two sets may be combined using the OR or AND 
logical operators. 



Trace Condition 



;any slate! □ no state 



state 
sell 

□ a Db Uc 
IZI d CH range 

□ not range 

Oor Onor 



□ OR 

□ and 



rset2 

□ e Df Do 

□ h □ aim 

O or O noi 



Count 



□ K 



Cancel | 



Jielp | 



The range and pattern resources are defined by double-clicking on the 
resource name in the Pattern/Range list box. 



170 



Chapter 5: Debugging Programs 
Setting Up Custom Trace Specifications 



If you double-click on a pattern name, the Trace Pattern dialog box is opened 
to let you specify address, data, and status values. By selecting the NOT 
check box, you can specify all states other than those identified by the 
address, data, and status values. The Direct check box lets you specify 
status values other than those that have been predefined. 



□ HOT 

Address: 

Data: 

Status: 



□ Direct: 



Trace Pattern 



OK 



Cancel 



Clear 



bg 


dmawrite word 


byte 


exec write 


cpu 


fetch 


data 


fg 


dataread 


hold 


datawrite 


mx 


dma 


read 


dmaread 


ref 



Help 



If you double-click on the range resource, the Trace Range dialog box is 
opened to let you select either the Address range option or the Data range 
option and enter the minimum and maximum values in the range. 



Bus' 



® Address 
O Data 



Minimum: 



Maximum: 



Trace Range 



OK 



Cancel 



Clear 



Help 
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Example 



To specify address "convert_case" as the trigger condition: 



Sequence Trace 



Sequence 



Primary 
Branch: 



Secondary 
Branch: 



Page 



dxl J 2 I 


no state I 1 j 


any state j 


any state j 3 j 


no state 


1 1 


any state j 


any state j 4 j 


no state 


1 1 


any state | 


any state J 5 j 


no state | 1 J 


any state 



Store: 




♦ trigger start 
O trigger center 
O trigger end 
EH Break on Trigger 



Pattern/Range: (Select with:Return/DblClick) 



A:convert_case D: S: 

A: D: S: 
A: D: S: 
A: D: S: 
A: D: S: 



Help 



Example 



To specify execution of "convert_case" and "next_message" as the trigger 
sequence: 



Sequence 



Primary 
Branch: 



Secondary 
Blanch: 



1 


a x1 


h 


2 


b x1 


I 


3 


any state 


h 


4 


any state 


h 



no state 






no state 




no state j 1 


no state 







Pattern/Range: (Select with:Retum/DblClick) 



Page 



j 



Store: 



any state j 



any state 



any state 



any state 



Trigger On: 

Count: 

Prestore: 



trigger start 
O trigger center 
O trigger end 
EJ Break on Trigger 



a = A:convert_case D: S: 

b = A:next_message D: S: 

c = A: D: S: 

d = A: D: S: 

e = A D: S: 



no state 



OK 



Cancel 



Cleai 



Load... 



Save., j 



Help 
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To edit a trace specification 

1 Choose the Trace^Edit... (ALT, T, E) command. 

2 Using the Sequence Trace dialog box, edit the trace specification as 
desired. 

3 Choose the OK button. 

You can use this command to edit trace specifications, including trace 
specifications that are automatically set up. For example, you can use this 
command to edit the trace specification that is set up when the 
Trace— ^Function Flow (ALT, T, F) command is chosen. 



To trace "windows" of program execution 

1 Because pairs of sequence levels are used to capture window enable 
and disable states both before and after the trigger, choose the 
Trace— >Sequence... (ALT, T, Q) command. 

2 Set up the sequence levels, patterns, and other trace options (as 
described below) in the Sequence Trace dialog box. 

3 Choose the OK button. 

When you trace "windows" of program execution, you store states that occur 
between one state and another state. This is different than the trace 
specification set up by the Trace— ^Statement... (ALT, T, S) command which 
stores states in a function's range of addresses. 

In a typical windowing trace specification, sequence levels are paired. The 
first sequence level searches for the window enable state, and no states are 
stored while searching. When the window enable state is found, the second 
sequence level stores the states you're interested in while searching for the 
window disable state. 
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If you want to store the window of code execution before and after the 
trigger condition, use two sets of paired sequence levels: one window 
enable/disable pair of sequence levels before the trigger, and another 
disable/enable pair after the trigger as shown below. 



WHILE STORING 



FIND 



ELSE ON GO TO 



no state 



any state 



any state 



no state 



window enable 
state 



trigger state 



window disable 
state 

window enable 
state 




no state 



window disable 



state 



no state 



Notice that the order of the second sequence level pair is swapped; if you 
find the trigger condition while searching for the window disable state, you 
want the analyzer to branch to a sequence level that continues to search for 
the disable state. 



174 



Chapter 5: Debugging Programs 
Setting Up Custom Trace Specifications 



Example 



To trace the window of code execution between lines 32 and 37 of the sample 
program, triggering on any state in the window: 



Sequence Trace 



Sequence 





Primary 
Branch: 




Secondary 
Branch: 




Page 




to 


to 


Store: 


1 


e x1 


hi 


no state j 1 




no state 


2 


any state 


hi 


- 




any slale 


3 


dx1 


hi 


no state 




no state 


4 


e x1 


hi 


no state 


1 i 


any state ] 



Trigger On: 
Count: 
Prestore: 

<§> trigger start 
O trigger center 
O trigger end 
EH Break on Trigger 



Pattern/Range: (Select with: Double-Click) 



a - A: D: S: 
b = A: D: S: 
c = A: D: S: 



d - A;sample\\tt0037 D: S; 



nple\\tt0032 D: S: 



OK 



Cancel! 



Clear 



Load, | 
Help j 



Notice that the analyzer triggers on the entry to sequence level 3. The 
primary branch condition in level 2 actually specifies the trigger condition. 



To store the current trace specification 

1 Choose the Trace^Edit... (ALT, T, E) command. 

2 Choose the Save... button. 

3 Specify the name of the trace specification file. 

4 Choose the OK button. 

You can also store trace specifications from the Trigger Store Trace, Find 
Then Trigger Trace, or Sequence Trace dialog boxes. 

The extension for trace specification files defaults to ".TRC". 
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To load a stored trace specification 

1 Choose the Trace^Trigger Store... (ALT, T, T), Trace^Find Then 
Trigger... (ALT, T, D), Trace^Sequence... (ALT, T, Q), or 
Trace^Edit... (ALT, T, E) command. 

2 Choose the Load... button. 

3 Select the desired trace specification file. 

4 Choose the OK button. 

A "Trigger Store" trace specification file can be loaded into any of the trace 
setting dialog boxes. A "Find Then Trigger" trace specification file can be 
loaded into either the Find Then Trigger Trace or Sequence Trace dialog 
boxes. A "Sequence" trace specification file can only be loaded into the 
Sequence Trace dialog box. 
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Reference 

Descriptions of the product in a dictionary or encyclopedia format. 
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This section lists the Real-Time C Debugger break macro and command file 
commands, providing syntax and brief description for each of the listed 
commands. For details on each command, refer to the command 
descriptions. 

The characters in parentheses can be ignored for shortcut entry. 



Run Control Commands 



Command 


Param_l 


Param_2 


Param_3 


Param_4 


Operation 


BRE (AK) 










Breaking execution 


COM(E) 










Run to cursor-indicated 












line 


OVE (R) 










Stepping over 


OVE (R) 


count 








Repeated a number of times 


OVE (R) 


count 


address 






From specified address 


OVE (R) 


count 


STA (RT) 






From transfer address 


RES (ET) 










Resetting processor 


RET (URN) 










Until return 


RUN 










From current address 


RUN 


address 








From specified address 


RUN 


STA (RT) 








From transfer address 


RUN 


RES (ET) 








From reset 


STE (P) 










Stepping 


STE (P) 


count 








Repeated a number of times 


STE (P) 


count 


address 






From specified address 


STE (P) 


count 


STA (RT) 






From transfer address 




Variable and Memory Commands 




Command 


Param_l 


Param_2 


Param_3 


Param_4 


Operation 


MEM (ORY) 


address 








Changing address displayed 


MEM (ORY) 


address 


TO 


value 




Editing memory contents 


MEM (ORY) 


FIL (L) 


size 


addr-range 


value 


Filling memory contents 


MEM (ORY) 


COP (Y) 


size 


addr-range 


address 


Copying memory contents 


MEM (ORY) 


IMA (GE) 


size 


addr-range 




Copying target memory 


MEM (ORY) 


LOA (D) 


format 


filename 




Loading memory from a file 


MEM (ORY) 


STO (RE) 


format 


addr-range 


filename 


Storing memory to a file 


MEM (ORY) 


BYT (E) 








Byte format display 


MEM (ORY) 


WOR (D) 








16-Bit format display 


MEM (ORY) 


ABS (OLUTE) 








Single-column display 


MEM (ORY) 


BLO (CK) 








Multi-column display 


MEM (ORY) 


LON (G) 








32-Bit format display 


10 


SET 


size 


address 




Registering I/O display 


10 


DEL (ETE) 


size 


address 




Deleting I/O display 


10 


size 


address 


TO value 




Editing I/O 


VAR ( TABLE) 


address 


TO 


value 




Editing variable 
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WP 


SET 


address 








WP 


DEL (ETE) 


address 






Deleting watchpoint 


WP 


DEL (ETE) 


ALL 






Deleting 9.11 watchpoint s 




Breakpoint Commands 






Command 


Param_l 


Param_2 


Param_3 


Param_4 


Operation 


BM 


SET 


linenumber 


command 




Setting break macro 


BM 


SET 


plinenum 


command 




Setting break macro 


BM 


DEL (ETE) 


linenumber 






Deleting break macro 


BM 


DEL (ETE) 


plinenum 






Deleting break macro 


BP 


SET 


address 






Setting breakpoint 


BP 


DEL (ETE) 


address 






Deleting breakpoint 


BP 


DEL (ETE) 


ALL 






Deleting breakpoint 


BP 


DISABLE 


address 






Disabling a breakpoint 


BP 


ENABLE 


address 






Enabling a breakpoint 


EVA (LUATE) 


address 








Expression window display 


EVA (LUATE) 


"strings" 








Printing string 


EVA (LUATE) 


CLE (AR) 








Clearing Expression window 



Window Open/Close Command 



Command 


Param_l 


Param_2 Param_3 


Param_4 


Operation 


DIS 


(PLAY) 


BAC 


(KTRACE) 






Opening 


BackTrace window 


DIS 


(PLAY) 


BAS 


(IC) 






Opening 
window 


Basic Register 


DIS 


(PLAY) 


BUT 


(TON) 






Opening 


Button window 


DIS 


(PLAY) 


EXP 


(RESSION) 






Opening 


Expression window 


DIS 


(PLAY) 


I/O 








Opening 


I/O window 


DIS 


(PLAY) 


MEM 


(ORY) 






Opening 


Memory window 


DIS 


(PLAY) 


REG 


(ISTER) 


window-num 




Opening 
window 


SFR Registers 


DIS 


(PLAY) 


SOU 


(RCE) 






Opening 


Source window 


DIS 


(PLAY) 


STA 


(TUS) 






Opening 


Status window 


DIS 


(PLAY) 


SYM 


(BOL) 






Opening 


Symbol window 


DIS 


(PLAY) 


TRA 


(CE) 






Opening 


Trace window 


DIS 


(PLAY) 


WAT 


(CHPOINT) 






Opening 


WatchPoint window 


ICO 


(NIC) 


BAC 


(KTRACE) 






Closing 


BackTrace window 


ICO 


(NIC) 


BAS 


(IC) 






Closing 
window 


Basic Register 


ICO 


(NIC) 


BUT 


(TON) 






Closing 


Button window 


ICO 


(NIC) 


EXP 


(RESSION) 






Closing 


Expression window 


ICO 


(NIC) 


I/O 








Closing 


I/O window 


ICO 


(NIC) 


MEM 


(ORY) 






Closing 


Memory window 


ICO 


(NIC) 


REG 


(ISTER) 


window-num 




Closing 
window 


SFR Registers 


ICO 


(NIC) 


SOU 


(RCE) 






Closing 


Source window 


ICO 


(NIC) 


STA 


(TUS) 






Closing 


Status window 


ICO 


(NIC) 


SYM 


(BOL) 






Closing 


Symbol window 


ICO 


(NIC) 


TRA 


(CE) 






Closing 


Trace window 


ICO 


(NIC) 


WAT 


(CHPOINT) 






Closing 


WatchPoint window 
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Configuration Command 



Command 


Param_l 


Param_2 


Param_3 


Param_4 


Operation 


MON ( I TOR) 


STA (RT) 








Starting monitor 


MON ( I TOR) 


mon-item 


mon-ans 






Setting up monitor 


MON (I TOR) 


END 








Ending monitor 


CON (FIG) 


STA (RT) 








Starting configuration 


CON (FIG) 


conf ig-item 


conf ig-ans 






Executing configuration 


CON (FIG) 


END 








Ending configuration 


MAP 


STA (RT) 








Starting mapping 


MAP 


addr-range 


memtype 






Executing mapping 


MAP 


OTHER 


memt ype 






Mapping OTHER area 


MAP 


END 








Ending mapping 


MOD (E) 


MNE (MONIC) 


ON 






Enabling Mnemonic display 


MOD (E) 


MNE (MONIC) 


OFF 






Enabling Source display 


MOD (E) 


REA (LTIME) 


ON 






Enabling real-time mode 


MOD (E) 


REA (LTIME) 


OFF 






Disabling real-time mode 


MOD (E) 


IOG ( UARD ) 


ON 






Enabling I/O guard 


MOD (E) 


IOG (UARD) 


OFF 






Disabling I/O guard 


MOD (E) 


MEM (ORYPOLL) 


ON 






Enabling Memory polling 


MOD (E) 


MEM (ORYPOLL) 


OFF 






Disabling Memory polling 


MOD (E) 


WAT (CHPOLL) 


ON 






Enabling WatchPoint polling 


MOD ( E ) 


WAT (CHPOLL) 


OFF 






Disabling WatchPoint 
polling 


MOD (E) 


LOG 


ON 






Enabling log file output 


MOD (E) 


LOG 


OFF 






Disabling log file output 


MOD (E) 


BNC 


IN 






Setting BNC input 


MOD (E) 


BNC 


OUT 






Setting BNC output 


MOD (E) 


SOU (RCE) 


ASK (PATH) 






Prompt for source paths 


MOD (E) 


SOU (RCE) 


NOA (SKPATH) 






Don't prompt for source 
paths 


MOD (E) 


SOU (RCE) 


DIS (PLAY) 


mOxO 




Specifying mOxO as mx flag 


MOD (E) 


SOU (RCE) 


DIS (PLAY) 


mOxl 




Specifying mOxl as mx flag 


MOD (E) 


SOU (RCE) 


DIS (PLAY) 


mlxO 




Specifying mlxO as mx flag 


MOD (E) 


SOU (RCE) 


DIS (PLAY) 


mlxl 




Specifying mlxl as mx flag 


MOD (E) 


TRACECLOCK 


BACKGROUND 






Trace background cycles 


MOD (E) 


TRACECLOCK 


BOTH 






Trace all processor cycles 


MOD (E) 


TRACECLOCK 


USER 






Trace user program cycles 



File Command 



Command 


Param_l 


Param_2 


Param_3 


Param_4 


Operation 


FIL (E) 


SOU (RCE) 


modulename 






Displaying source file 


FIL (E) 


OBJ (ECT) 


filename 






Loading object 


FIL (E) 


SYM (BOL) 


filename 






Loading symbol 


FIL (E) 


BIN (ARY) 


filename 






Loading data 


FIL (E) 


APPEND 


filename 






Appending symbol 


FIL (E) 


COM (MAND) 


filename 






Executing command file 


FIL (E) 


LOG 


filename 






Specifying command log file 


FIL (E) 


CON (FIGURATION) LOA(D) 


filename 




Loads config. from file 


FIL (E) 


CON (FIGURATION) STO(RE) 


filename 




Stores configuration 












to file 


FIL (E) 


ENV ( IRONMENT ) LOA(D) 


filename 




Loads environment from file 


FIL (E) 


ENV ( IRONMENT ) SAV(E) 


filename 




Stores environment to file 




Trace Commands 






Command 


Param_l 


Param_2 


Param_3 


Param_4 


Operation 


TRA (CE) 


FUN (CTION) 


FLO (W) 






Tracing function flow 


TRA (CE) 


FUN (CTION) 


CAL (L) 


f uncname 




Tracing function call 


TRA (CE) 


FUN (CTION) 


STA (TEMENT) 


f uncname 




Tracing statement 
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TRA 


(CE) 


VAR 


(IABLE) 


ACC (ESS) 


address 




Tracing access to variable 


TRA 


(CE) 


VAR 


(IABLE) 


BRE (AK) 


address 


value 


Setting breakpoint variable 


TRA 


(CE) 


STO 


(P) 








Stopping tracing 


TRA 


(CE) 


ALW 


(AYS) 








Tracing until halt 


TRA 


(CE) 


AGA 


(IN) 








Restarting tracing 


TRA 


(CE) 


SAV 


(E) 


filename 






Storing trace specification 


TRA 


(CE) 


LOA 


(D) 


filename 






Loading trace specification 


TRA 


(CE) 


CUS 


(TOMIZE) 








Starts trace w/loaded spec. 


TRA 


(CE) 


DIS 


(PLAY) 


SOU (RCE) 






Enabling source display 


TRA 


(CE) 


DIS 


(PLAY) 


BUS 






Enabling bus display 


TRA 


(CE) 


DIS 


(PLAY) 


ABS (OLUTE) 






Displaying absolute time 


TRA 


(CE) 


DIS 


(PLAY) 


REL (ATIVE) 






Displaying relative time 


TRA 


(CE) 


COP 


(Y) 


DISPLAY 






Copying trace display 


TRA 


(CE) 


COP 


(Y) 


ALL 






Copying trace results 


TRA 


(CE) 


FIN 


(D) 


TRI (GGER) 






Centers trigger in window 


TRA 


(CE) 


FIN 


(D) 


STA (TE) 


□ t"3hp — nnm 

Ol-QUC 1 - L.. i L L 




Centers state in window 


TRA 


(CE) 


COP 


(Y) 


SPE (C) 






Copying specification 








Symbol Window 


( ^fiiiim :l 11(1^ 

V VJ1II1II(11I\1.~ 






Command 


Param_l 


Param_2 


Param_3 


Param_4 


Operation 


SYM 


(BOL) 


LIS 


(T) 


MOD (ULE) 






Displaying module 


SYM 


(BOL) 


LIS 


(T) 


FUN (CTION) 






Displaying function 


SYM 


(BOL) 


LIS 


(T) 


EXT (ERNAL) 






Displaying global symbol 


SYM 


(BOL) 


LIS 


(T) 


INT (ERNAL) 


f uncname 




Displaying local symbol 


SYM 


(BOL) 


LIS 


(T) 


GLO (BAL) 






Displaying global asm 
















symbol 


SYM 


(BOL) 


LIS 


(T) 


LOG (AL) 


modulename 




Displaying local asm symbol 


SYM 


(BOL) 


ADD 




usersymbol 


address 




Adding user-defined 
















symbol 


SYM 


(BOL) 


DEL 


(ETE) 


usersymbol 






Deleting user-defined 
















symbol 


SYM 


(BOL) 


DEL 


(ETE) 


ALL 






Deleting all user symbols 


SYM 


(BOL) 


MAT 


(CH) 


"strings" 






Displaying matched string 


SYM 


(BOL) 


COP 


(Y) 


DIS (PLAY) 






Copying symbol display 


SYM 


(BOL) 


COP 


(Y) 


ALL 






Copying all symbols 
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Command File Control Command 

Param_4 



value 
value 



Command 


Param_l 


Param_2 


Param_3 


EXIT 








EXIT 


VAR ( I ABLE ) 


address 


value 


EXIT 


REG (ISTER) 


regname 


value 


EXIT 


MEM (ORY) 


size 


address 


EXIT 


I/O 


size 


address 


WAIT 


MON ( I TOR) 






WAIT 


RUN 






WAIT 


UNK (NOWN) 






WAIT 


SLO (W) 






WAIT 


TGT (RESET) 






WAIT 


SLE (EP) 






WAIT 


GRA (NT) 






WAIT 


NOB (US) 






WAIT 


TCO (M) 






WAIT 


THA (LT) 






WAIT 


TIM (E) 


seconds 





Operation 

Exiting command file 
Exiting with variable cont . 
Exiting with register cont. 
Exiting with memory 

contents 
Exiting with I/O contents 
Wait until MONITOR status 
Wait until RUN status 
Wait until UNKNOWN status 
Wait until SLOW CLOCK 

status 



until TARGET RESET 
until SLEEP status 
until BUS GRANT status 



Wait 
Wait 
Wait 

Wait until NOBUS status 
Wait until end of trace 
Wait until halt 
Wait a number of seconds 



Miscellaneous Commands 



Command 

ASM 
BEE (P) 
BUTTON 

QUI (T) 
COP (Y) 
COP (Y) 

COP (Y) 
COP (Y) 

COP (Y) 
COP (Y) 
COP (Y) 
COP (Y) 
COP (Y) 
CUR(SOR) 
DIR (ECTORY) 
NOP 

REG (ISTER) 
SEA (RCH) 
SEA (RCH) 
SEA (RCH) 
SEA (RCH) 



Param_l 

address 



label 



TO 

BAS (IC) 



SOU (RCE) 
REG (ISTER) 



Param_2 Param_3 Param_4 

user_symbol "inst_string" 

"command" 



filename 



window-num 



MEM (ORY) 
WAT (CHPOINT) 
BAG (KTRACE) 

10 

EXP (RESSION) 

address 

directoryname 



regname 
STR(ING) 
FUN (CTION) 
MEM (ORY) 
MEM (ORY) 



TO 

direction 
f uncname 
size 
STR (ING) 



value 
case 

addr-range 
"strings" 



strings 



value 



Operation 

In-line assembler 

Sounding beep 

Adds button to Button 

Window 
Exiting debugger 
Specifying copy destination 
Copying Basic Register 

Window 

Copying Source window 
Copying SFR Registers 
Window 

Copying Memory window 
Copying WatchPoint window 
Copying BackTrace window 
Copying I/O window 
Calling Expression window 
Positioning cursor 
Directory for source search 
Non-operative 
Editing register contents 
Searching string 
Selecting function 
Searching memory 
Searching memory for string 
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Parameters 



Parameter 


Description 


Notation 


address 


Address 


See "Reference". 


addr-range 


Address range 




case 


Case sensing 




command 


Macro command 


Commands listed in the "Reference". 


conf ig-ans 


Setting 


See "Reference". 


conf ig-item 


Configuration 


See "Reference". 


count 


Count 


Decimal notation 


direction 


Search direction 




direct oryname 


Directory name 




filename 


File name 




format 


Memory file format 




f uncname 


Function name 




label 


Button label 




linenumber 


Line number 




memtype 


Memory type 




modulename 


Module name 




mon-ans 


Setting 


See "Reference". 


mon-item 


Configuration 


See "Reference". 


plinenum 


Macro line number 


line number. macro number (ex. 34.1) 


seconds 


Time in seconds 




size 


Data size 




space 


Memory or I/O space 




regname 


Register name 




strings 


String 


"string" 


usersymbol 


User-defined symbol 


See "Reference". 


value 


Value 


See "Reference". 


window-num 


SFR Window number 
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Expressions in Commands 



When you enter values and addresses in commands, you can use: 

• Numeric constants (hexadecimal, decimal, octal, or binary values). 

• Symbols (identifiers). 

• C operators (pointers, arrays, structures, unions, unary minus operators) 
and parentheses (specifying the order of operator evaluation). 



Chapter 7: Expressions in Commands 
Numeric Constants 



Numeric Constants 

All numeric constants without a suffix that indicates the base are assumed to 
be hexadecimal, except when the number refers to a count; count values are 
assumed to be decimal. 

The debugger expressions support the following numeric constants with or 
without radix: 

Hexadecimal Alphanumeric strings starting with "Ox" or "OX" and 

consisting of any of '0' through '9', 'A through 'F', or 'a' 
through 'f (for example: 0x12345678, OxFFFFOOOO). 

Alphanumeric strings starting with any of '0' through '9', 
ending with 'H' or 'h', and consisting of any of '0' through 
'9', A' through T", or 'a' through 'f (for example: 
12345678H, OFFFFOOOOh). 

Alphanumeric strings starting with any of '0' through '9' 
and consisting of any of '0' through '9', A' through 'F', or 'a' 
through T (for example: 12345678, 0FFFF0000). 

Decimal Numeric strings consisting of any of '0' through '9' and 

ending with T or 't' (for example: 128T, lOOOt). 

Octal Numeric strings consisting of any of '0' through '7' and 

ending with 'O' or 'o' (not zero) (for example: 200o, 3770). 

Binary Numeric strings consisting of '0' or T and ending with T or 

V (for example: lOOOOOOOy, 11001011Y). 
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Symbols 

The debugger expressions support the following symbols (identifiers): 

• Symbols defined in C source code. 

• Symbols defined in assembly language source code. 

• Symbols added with the Symbol window control menu's User 
defined->Add... (ALT, -, U, A) command. 

• Line number symbols. 

Symbol expressions may be in the following format (where bracketed parts 
are optional): 

[module_name\\ ] symbol_name [ , f ormat_spec ] 
Module Name 

The module names include C/Assembler module names as follows: 

Assembler (file_path)asm_file_name 
module name 

C module name source_file_name 
(without extension) 

Symbol Name 

The symbol names include symbols defined in C/Assembler source codes, 
user-defined symbols, and line number symbols: 

User-defined Strings consisting of up to 256 characters including: 
symbols alphanumeric characters, _ (underscore), and ? (question 

mark) . 

Line number #source_file_line_number 
symbols 
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Symbols 



The symbol names can also include either * or & to explicitly specify the 
evaluation of the symbol. 

Symbol address &symbol_name 

Symbol data *symbol_name 

Format Specification 

The format specifications define the variable display format or size for the 
variable access or break tracing: 

String s 

Decimal d (current size), d8 (8 bit), dl6 (16 bit), d32 (32 bit) 

Unsigned u (current size), u8 (8 bit), ul6 (16 bit), u32 (32 bit) 

decimal 

Hexadecimal x (current size), x8 (8 bit), xl6 (16 bit), x32 (32 bit) 



Examples Some example symbol expressions are shown below: 

sample\\#2 2, x32 
data[0] .message, s 
*dat->message, s 
dat->message, x32 
sampleWdata [ 1 ] . status, d32 
&data [0] 
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C Operators 

The debugger expressions support the following C operators. The order of 
operator evaluation can be modified using parentheses '(' and ')'; however, it 
basically follows C conventions: 

Pointers '*' and '&' 

Arrays '[' and ']' 

Structures or unions '.' and "->" 

Unary minus 
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Menu Bar Commands 



This chapter describes the commands that can be chosen from the menu bar. 
Command descriptions are in the order they appear in the menu bar (top to 
bottom, left to right). 

• File^Load Object... (ALT, F, L) 

• File->Command Log->Log File Name... (ALT, F, C, N) 

• File->Command Log->Logging ON (ALT, F, C, O) 

• File->Command Log^Logging OFF (ALT, F, C, F) 

• File->Run Cmd File. . . (ALT, F, R) 

• File->Load Debug... (ALT, F, D) 

• File-Save Debug... (ALT, F, S) 

• File->Load Emulator Config... (ALT, F, E) 

• File-Save Emulator Config. . . (ALT, F, V) 

• File->Copy Destination... (ALT, F, P) 

• File->Exit (ALT, F, X) 

• File^Exit HW Locked (ALT, F, H) 

• Execution->Run (ALT, E, U) 

• Execution— >Run to Cursor (ALT, R C) 

• Execution->Run to Caller (ALT, E, T) 

• Execution->Run... (ALT, E, R) 

• Execution-Single Step (ALT, E,N) 

• Execution-Step Over (ALT, E, O) 

• Execution-Step... (ALT, E, S) 

• Execution-^Break (ALT, E, B) 

• Execution-^Reset (ALT, E, E) 

• Breakpoint-Set at Cursor (ALT, B, S) 

• Breakpoint-^Delete at Cursor (ALT, B, D) 

• Breakpoint-Set Macro... (ALT, B, M) 

• Breakpoint-^Delete Macro (ALT, B, L) 

• Breakpoint-^ dit... (ALT, B, E) 

• Variable^Edit... (ALT, V, E) 

• Trace->Function Flow (ALT, T, F) 

• Trace^Function Caller... (ALT, T, C) 

• Trace->Function Statement... (ALT, T, S) 
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• Trace->Variable Access... (ALT, T, V) 

• Trace->Variable Break... (ALT, T, B) 

• Trace-Edit... (ALT, T, E) 

• Trace->Trigger Store... (ALT, T, T) 

• Trace-Eind Then Trigger... (ALT, T, D) 

• Trace->Sequence... (ALT, T, Q) 

• Trace-Entil Halt (ALT, T, U) 

• Trace-Ealt (ALT, T, H) 

• Trace->Again (ALT, T, A) 

• RealTime— ^Monitor Intrusion— ^Disallowed (ALT, R, T, D) 

• RealTime->Monitor Intrusion->Allowed (ALT, R, T, A) 

• RealTime-EO Polling->ON (ALT, R, I, O) 

• RealTime-EO Polling->OFF (ALT, R, I, F) 

• RealTime-AVatchpoint Polling->ON (ALT, R, W, 0) 

• RealTime-AVatchpoint Polling^OFF (ALT, R, W, F) 

• RealTime-^Memory Polling^ON (ALT, R, M, 0) 

• RealTime-^Memory Polling^OFF (ALT, R, M, F) 

• Assemble... (ALT, A) 

• Settings-Emulator Config-Eardware... (ALT, S, E, H) 

• Settings-Emulator Config-^Memory Map... (ALT, S, E, M) 

• Settings-Emulator Config->Monitor... (ALT, S, E, O) 

• Settings-Emulator Config-^Trace Options... (ALT, S, E, T) 

• Settings-Emulator Config^Pod... (ALT, S, E, P) 

• Settings-Eommunication... (ALT, S, C) 

• Settings-ENC->Output Analyzer Trigger (ALT, S, B, O) 

• Settings-ENC->Inputs Analyzer Arm (ALT, S, B, I) 

• Settings-Eoverage-Eoverage ON (ALT, S, V, O) 

• Settings-Eoverage-Eoverage OFF (ALT, S, V, F) 

• Settings— ^Coverage— ^Coverage Reset (ALT, S, V, R) 

• Settings-Eont... (ALT, S, F) 

• Settings-^Tabstops... (ALT, S, T) 

• Settings-^Tabstops... (ALT, S, T) 

• Settings-Extended Settings ->Trace Cycles-Eser (ALT, S, X, T, U) 

• Settings-Extended Settings ->Trace Cycles-^Monitor (ALT, S, X, T, M) 

• Settings-Extended Settings ->Trace Cycles-Eoth (ALT, S, X, T, B) 

• Settings-Extended Settings -Eoad Error Abort-EN (ALT, S, X, L, 0) 

• Settings-Extended Settings -Eoad Error Abort-EFF (ALT, S, X, L, F) 
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• Settings-Extended Settings -^Source Path Query->ON (ALT, S, X, S, O) 

• Settings-Extended Settings -^Source Path Query->OFF (ALT, S, X, S, 
F) 

• Window-^Cascade (ALT, W, C) 

• Window-^Tile (ALT, W, T) 

• Window— > Arrange Icons (ALT, W, A) 

• Window->l-9 <win_name> (ALT, W, 1-9) 

• Window-^More Windows... (ALT, W, M) 

• Help->About Debugger/Emulator... (ALT, H, D) 
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File^Load Object... (ALT, F, L) 



Loads the specified object file and symbolic information into the debugger. 

Program code is loaded into emulation memory or target system RAM. 

Object files must be IEEE-695 format absolute files. Some software 
development tools that generate this format are: 

IAR 7700 Compiler 

IAR 7700 Assembler 

IAR UBROF IEEE-695 file converter 

MRI MCC77 Compiler 

MRI ASMM77 Assembler 

Mitsubishi NC77 Compiler 

Mitsubishi RASMC77 Assembler 

Mitsubishi IEEE-695 object format converter 

Load Object File Dialog Box 

Choosing the File— »Load Object... (ALT, F, L) command opens the following 
dialog box: 



Current: 
File Name: 
Bytes Loaded: 



Load Object File 



C:\HP\RTC\M7700\DEMO\SA 



\DEMO\SAMPLE\SAMPLE.X 



□ Symbols Only 

□ Data Only 

□ Symbols Append 



B] 1 Cancel I 



Browse. 
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File^Load Object... (ALT, F, L) 



Current Shows the currently loaded object file. 

File Name Specifies the object file to be loaded. The system defaults 

the file extension to ".x". 



Bytes Loaded 
Symbols Only 



Data Only 

Symbols 
Append 



Load 



Displays the loaded data in Kbytes. 

Loads only the symbolic information. This is used when 
programs are already in memory (for example, when the 
debugger is exited and re-entered without turning OFF 
power to the target system or when code is in target 
system ROM). 

Loads program code but not symbols. 

Appends the symbols from the specified object file to the 
currently loaded symbols. This lets you debug code loaded 
from multiple object files. 

Starts loading the specified object file and closes the dialog 
box. 



Cancel Closes the dialog box without loading the object file. 

Browse... Opens a file selection dialog box from which you can select 

the object file to be loaded. 



Command File Command 

FIL(E) OBJ(ECT) file_name 

Loads the specified object file and symbols into the debugger. 
FIL(E) SYM(BOL) file_name 

Loads only the symbolic information from the specified object file. 
FIL(E) BIN (ARY) file_name 

Loads only the program code from the specified object file. 
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File^Load Object... (ALT, F, L) 



FIL(E) APP (END) file_name 

Appends the symbol information from the specified object file to the 
currently loaded symbol information. 



See Also 

"To load user programs" in the "Loading and Displaying Programs" section of 
the "Debugging Programs" chapter. 
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File-^Command Log— >Log File Name... (ALT, F, C, N) 



File^Command Log^Log File Name... (ALT, F, C, N) 

Lets you name a new command log file. 

The current command log file is closed and the specified command log file is 
opened. The default command log file name is "log.cmd". 

Command log files can be executed with the File— >Run Cmd File... (ALT, F, 
R) command. 

The File->Command Log->Logging OFF (ALT, F, C, F) command stops the 
logging of executed commands. 

This command opens a file selection dialog box from which you can select the 
command log file. Command log files have a ".CMD" extension. 

Command File Command 

FIL(E) LOG filename 

See Also 

"To create a command file" in the "Using Command Files" section of the 
"Using the Debugger Interface" chapter. 



200 



Chapter 8: Menu BarCommands 
File->Command Log— ^Logging ON (ALT, F, C, 0) 



File^Command Log^Logging ON (ALT, F, C, O) 

Starts command log file output. 

The File^Command Log->Log File Name... (ALT, F, C, N) command 
specifies the destination file. 

Command File Command 

MOD (E) LOG ON 

See Also 

"To create a command file" in the "Using Command Files" section of the 
"Using the Debugger Interface" chapter. 
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File-^Command Log— ^Logging OFF (ALT, F, C, F) 



File^Command Log^Logging OFF (ALT, F, C, F) 

Stops command log file output. 

The File^Command Log->Log File Name... (ALT, F, C, N) command 
specifies the destination file. 

Command File Command 

MOD (E) LOG OFF 

See Also 

"To create a command file" in the "Using Command Files" section of the 
"Using the Debugger Interface" chapter. 
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File^RunCmd File... (ALT, F, R) 



File^Run Cmd File... (ALT, F, R) 

Executes the specified command file. 
Command files can be: 

• Files created with the File— ^Command Log— >Log File Name... (ALT, F, C, 
N) command. 

• Configuration files having .CMD extension. 

Command files are stored as ASCII text files so they can be created or edited 
with ASCII text editors. 

Command File Execution Dialog Box 

Choosing the File— >Run Cmd File... (ALT, F, R) command opens the 
following dialog box: 



File Name: 
Directory: 



Executing: 



Run Command File 



CAHP\RTC\M7700\DEMO\SAMPLE\SAMPLE.E 



c: V . . \m7700\demo\sample 



sampdemo. cmd 

sampemul.cmd 

sample.cmd 



Execute 



Stop I 

Close | 

Browse... j 

Help 1 
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File^Run Cmd File... (ALT, F, R) 



File Name Lets you enter the name of the command file to be 

executed. 



Directory Shows the current directory and the command files in that 

directory. You can select the command file name from this 
list. 



Parameters Lets you specify up to five parameters that replace 
placeholders $1 through $5 in the command file. 
Parameters must be separated by blank spaces. 

Executing Shows the command being executed. 

Execute Executes the command file. 

Stop Stops command file execution. 

Close Closes the dialog box. 

Browse... Opens a file selection dialog box from which you can select 

the command file name. 



Command File Command 

FIL(E) COM (MAND) filename args 



See Also 

"To execute a command file" in the "Using Command Files" section of the 
"Using the Debugger Interface" chapter. 
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File->Load Debug... (ALT, F,D) 



File^Load Debug... (ALT, F, D) 

Loads a debug environment file. 

This command opens a file selection dialog box from which you select the 
debug environment file. 

Debug environment files have the extension ".ENV". 
Debug environment files contain information about: 

• Breakpoints. 

• Variables in the WatchPoint window. 

• The directory that contains the currently loaded object file. 

Command File Command 

FIL(E) ENV (IRONMENT) LOA(D) filename 
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File^Save Debug... (ALT, F,S) 



File^Save Debug... (ALT, F, S) 

Saves a debug environment file. 

This command opens a file selection dialog box from which you select the 
debug environment file. 

The following information is saved in the debug environment file: 

• Breakpoints. 

• Variables in the WatchPoint window. 

• The directory that contains the currently loaded object file. 

Command File Command 

FIL(E) ENV (IRONMENT) SAV(E) filename 
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File— >Load Emulator Config... (ALT, F, E) 



File^Load Emulator Config... (ALT, F, E) 

Loads a hardware configuration command file. 

This command opens a file selection dialog box from which you select the 
hardware configuration file. 

Emulator configuration command files contain: 

• Hardware configuration settings. 

• Memory map configuration settings. 

• Monitor configuration settings. 

Command File Command 

FIL(E) CON (FIGURATION) LOA(D) filename 
See Also 

"To load an emulator configuration" in the "Saving and Loading 
Configurations" section of the "Configuring the Emulator" chapter. 
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File— »Save Emulator Config... (ALT, F, V) 



File^Save Emulator Config... (ALT, F, V) 

Saves the current hardware configuration to a command file. 

The following information is saved in the emulator configuration file: 

• Hardware configuration settings. 

• Memory map configuration settings. 

• Monitor configuration settings. 

Command File Command 

FIL(E) CON (FIGURATION) STO(RE) filename 
See Also 

"To save the current emulator configuration" in the "Saving and Loading 
Configurations" section of the "Configuring the Emulator" chapter. 
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File->Copy Destination... (ALT, F, P) 



File^Copy Destination... (ALT, F, P) 

Names the listing file to which debugger information may be copied. 

The contents of most of the debugger windows can be copied to the 
destination listing file by choosing the Copy— > Window command from the 
window's control menu. 

The Symbol and Trace windows' control menus provide the Copy— > All 
command for copying all of the symbolic or trace information to the 
destination listing file. 

This command opens a file selection dialog box from which you select the 
name of the output list file. Output list files have the extension ".LST". 

Command File Command 

COP (Y) TO filename 

See Also 

"To change the list file destination" in the "Working with Debugger Windows' 
section of the "Using the Debugger Interface" chapter. 
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File^Exit (ALT, F, X) 

Exits the debugger. 

Command File Command 

QUI (T) 

See Also 

"To exit the debugger" in the "Starting and Exiting the Debugger" section of 
the "Using the Debugger Interface" chapter. 

File->Exit HW Locked (ALT, F, H) 
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File^Exit HW Locked (ALT, F, H) 

Exits the debugger and locks the emulator hardware. 

When the emulator hardware is locked, your user name and ID are saved in 
the HP 64700 and other users are prevented from accessing it. 

You can restart the debugger and resume your debug session after re-loading 
the symbolic information with the File— >Load Object... (ALT, F, L) command. 

Command File Command 

QUI(T) LOC(KED) 

See Also 

Settings-^Communication... (ALT, S, C) 



211 



Chapter 8: Menu BarCommands 
File Selection Dialog Boxes 



File Selection Dialog Boxes 

File selection dialog boxes are used with several of the debugger commands. 
An example of a file selection dialog box is shown below. 



Log File Name 



File Name: 



700\demo\sample\log.cm 



log.cmd 
sampdemo.cmd 
sampemul.cmd 
sample.cmd 



List Files of Type: 



Log Files(*.CMD I 



Directories: 

c:V.Am7700\demo\sample 



OK 



& m7700 
fr^r demo 
sample 



Drives: 



S c: xmGOOl my 



Cancel 



Help 



3 



File Name You can select the name of the file from the list box and 

edit it in the text box. 

List Files of Lets you choose the filter for files shown in the File Name 
Type list box. 

Directories You can select the directory from the list box. The 
selected directory is shown above the list box. 

Drives Lets you select the drive name whose directories are 

shown in the Directories list box. 

OK Selects the named file and closes the dialog box. 

Cancel Cancels the command and closes the dialog box. 

Help If this button is available, it opens a help window for 

viewing the associated help information. 
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Execution^Run (F5), (ALT, E, U) 

Runs the program from the current program counter address. 

Command File Command 

RUN 
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Execution->Run to Cursor (ALT, E, C) 



Executions Run to Cursor (ALT, E, C) 

Runs from the current program counter address up to the Source window 
line that contains the cursor. 

This command sets a breakpoint at the cursor-selected source line and runs 
from the current program counter address; therefore, it cannot be used when 
programs are in target system ROM. 

If the cursor-selected source line is not reached within the number of 
milliseconds specified by StepTimerLen in the B3630.INI file, a dialog box 
appears from which you can cancel the command. When the Stop button is 
chosen, program execution stops, the breakpoint is deleted, and the 
processor continues RUNNING IN USER PROGRAM. 

Command File Command 

COM(E) address 

See Also 

"To run the program until the specified line" in the "Stepping, Running, and 
Stopping" section of the "Debugging Programs" chapter. 
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Execution^Run to Caller (ALT, E, T) 

Executes the user program until the current function returns to its caller. 

Because this command determines the address at which to stop execution 
based on stack frame data and object file function information, the following 
restrictions are imposed: 

• A function cannot properly return immediately after its entry point 
because the stack frame for the function has not yet been generated. 
Use the Step command to single-step the function before using this 
command. 

• An assembly language routine cannot properly return, even it follows C 
function call conventions, because there is no function information in the 
object file. 

• An interrupt function cannot properly return because it uses a stack in a 
different fashion from standard functions. 

Command File Command 

RET (URN) 

See Also 

"To run the program until the current function return" in the "Stepping, 
Running, and Stopping" section of the "Debugging Programs" chapter. 
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Execution^Run... (ALT, E, R) 

Executes the user program starting from the specified address. 

This command sets the processor status to RUNNING IN USER PROGRAM. 



Note If you try to run from an address whose symbol is START, STA, RESET, or 

RES (or any upper- or lower-case variation), the debugger instead runs from 
the start address or reset address, respectively, because these are the 
keywords used with the RUN command. To fix this problem, use START+0, 
STA+0, RESET+0, or RES+0 to force the symbol to be evaluated as an 
address. 



Run Dialog Box 

Choosing the Execution— >Run... (ALT, E, R) command opens the following 
dialog box: 



S Run 










Fiom 
O Cuiient PC 
O Stait Address 
O Usei Reset 
<§> Addiess: 


Run | 


Cancel | 




Help j 




1026a 











Current PC Specifies that the program run from the current program 
counter address. 

Start Address Specifies that the program run from the transfer address 
defined in the object file. 

User Reset The emulator is waiting for a RESET signal from target 

system. User program execution starts on reception of the 
RESET signal. 
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Execution-^Run... (ALT, E, R) 



Address 



Lets you enter the address from which to run. 



Run 



Initiates program execution from the specified address, 
then close the dialog box. 



Cancel 



Cancels the command and closes the dialog box. 



Command File Command 

RUN 

Executes the user program from the current program counter address. 
RUN STA(RT) 

Executes the user program from the transfer address defined in the object 
file. 

RUN RES (ET) 

Drives the target reset line and begins executing from the contents of 
exception vector 0. 

RUN address 

Executes the user program from the specified address. 
See Also 

"To run the program from a specified address" in the "Stepping, Running, and 
Stopping" section of the "Debugging Programs" chapter. 
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Execution^Single Step (F2), (ALT, E, N) 

Executes a single instruction or source line at the current program counter 
address. 

A single source line is executed when in the source only display mode, unless 
no source is available or an assembly language program is loaded; in these 
cases, a single assembly language instruction is executed. 

When in the mnemonic mixed display mode, a single assembly language 
instruction is executed. 

Command File Command 

STE (P) 

See Also 

"To step a single line or instruction" in the "Stepping, Running, and Stopping" 
section of the "Debugging Programs" chapter. 

Execution^Step Over (ALT, E, O) 
Execution^Step... (ALT, E, S) 
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Execution->Step Over (F3), (ALT, E, 0) 



Execution^Step Over (F3), (ALT, E, O) 

Executes a single instruction or source line at the current program counter 
except when the instruction or source line makes a subroutine or function 
call, in which case the entire subroutine or function is executed. 

This command is the same as the Execution— ^Single Step (ALT, E, N) 
command except when the source line contains a function call or the 
assembly instruction makes a subroutine call. In these cases, the entire 
function or subroutine is executed. 



The Execution— >Step Over (ALT, E, O) command may fail in single-stepping 
the source lines containing such loop statements as "while", "for", or "do 
while" statements. 



Command File Command 

OVE (R) 

See Also 

"To step over a function" in the "Stepping, Running, and Stopping" section of 
the "Debugging Programs" chapter. 
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Execution^Step... (ALT, E, S) 

Single-steps the specified number of instructions or source lines, starting 
from the specified address. 

Single source lines are executed when in the source only display mode, 
unless no source is available or an assembly language program is loaded; in 
these cases, single assembly language instructions are executed. 

When in the mnemonic mixed display mode, single assembly language 
instructions are executed. 



Note If you try to step from an address whose symbol is START or STA (or any 

upper- or lower-case variation), the debugger instead steps from the start 
address because these are the keywords used with the STEP and OVER 
commands. To fix this problem, use START+0 or STA+0 to force the symbol 
to be evaluated as an address. 



Step Dialog Box 

Choosing the Execution— >Step... (ALT, E, S) command opens the following 
dialog box: 



Fiom 
<«> Curient PC 

O Address: 



Count: 10| 



Step 



Close 



Stop 



Help j 



□ fivei 

□ Follow PC 
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Current PC Specifies that stepping start from the current program 
counter address. 

Start Address Specifies that stepping start from the start address or 
transfer address. 

Address Lets you enter the address from which to single-step. 

Count Indicates the step count. The count decrements by one for 

every step and stops at 1 . 

Over If the source line to be executed contains a function call or 

the assembly language instruction to be executed contains 
a subroutine call, this option specifies that the entire 
function or subroutine be executed. 



Follow PC 



Step 

Close 
Stop 



Source window information is updated every step 
execution. If this option is not selected, source window 
information is updated after all step executions are 
completed. 

Single-steps the specified number of instructions or source 
lines, starting from the specified address. 

Closes the dialog box. 

Stops single-stepping. 



Command File Command 

STE(P) count 

Single-steps the specified number of instructions or source lines, starting 
from the current program counter address. 

STE(P) count address 

Single-steps the specified number of instructions or source lines, starting 
from the specified address. 

STE(P) count STA(RT) 

Single-steps the specified number of instructions or source lines, starting 
from the transfer address defined in the object file. 
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Execution->Step... (ALT, E,S) 

OVE(R) count 

Single-steps the specified number of instructions or source lines, starting 
from the current program counter address. If an instruction or source line 
makes a subroutine or function call, the entire subroutine or function is 
executed. 

OVE (R) count address 

Single-steps the specified number of instructions or source lines, starting 
from the specified address. If an instruction or source line makes a 
subroutine or function call, the entire subroutine or function is executed. 

OVE(R) count STA(RT) 

Single-steps the specified number of instructions or source lines, starting 
from the transfer address defined in the object file. If an instruction or 
source line makes a subroutine or function call, the entire subroutine or 
function is executed. 

See Also 

"To step multiple lines or instructions" in the "Stepping, Running, and 
Stopping" section of the "Debugging Programs" chapter. 

Execution-Single Step (ALT, E, N) 
Execution-Step Over (ALT, E, O) 
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Execution^Break (F4), (ALT, E, B) 

Stop user program execution and break into the monitor. 

This command can also be used to break into the monitor when the processor 
is in the EMULATION RESET status. 

Once the command has been completed, the processor transfers to the 
RUNNING IN MONITOR status. 

Command File Command 

BRE (AK) 

See Also 

"To stop program execution" in the "Stepping, Running, and Stopping" 
section of the "Debugging Programs" chapter. 
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Execution^Reset (ALT, E, E) 

Resets the emulation microprocessor. 

If a foreground monitor is being used, it will automatically be loaded when 
this command is chosen. 

While the processor is in the EMULATION RESET state, no display or 
modification is allowed for the contents of target system memory or registers. 
Therefore, before you can display or modify target system memory or 
processor registers, you must use the Execution-^Break (ALT, E, B) 
command to break into the monitor. 

Command File Command 

RES (ET) 

See Also 

"To reset the processor" in the "Stepping, Running, and Stopping" section of 
the "Debugging Programs" chapter. 
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Breakpoints Set at Cursor (ALT, B, S) 

Sets a breakpoint at the cursor-selected address in the Source window. 

The breakpoint marker "BP" appears on lines at which breakpoints are set. 

When a breakpoint is hit, program execution stops immediately before 
executing the instruction or source code line at which the breakpoint is set. 

A set breakpoint remains active until it is deleted. 

Because breakpoints are set by replacing program opcodes with breakpoint 
instructions, they cannot be set in programs stored in target system ROM. In 
addition, breakpoints do not function properly when set at addresses where 
no opcode is found. 

The Breakpoint— »Set at Cursor (ALT, B, S) command replaces the original 
instruction at the specified address with a BRK instruction. When the 
emulator detects the BRK instruction, it breaks to the monitor and restores 
the original instruction. When the emulator detects a BRK instruction that 
was not inserted as a breakpoint, the emulator breaks and transfers to the 
"UNDEFINED BREAKPOINT at address" status. 

The Breakpoint— »Set at Cursor (ALT, B, S) command may cause BP markers 
to appear at two or more addresses. This happens when a single instruction 
is associated with two or more source lines. You can select the mnemonic 
display mode to verify that the breakpoint is set at a single address. 

Command File Command 

BP SET address 

See Also 

"To set a breakpoint" in the "Using Breakpoints and Break Macros" section of 
the "Debugging Programs" chapter. 
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Breakpoint^Delete at Cursor (ALT, B, D) 

Deletes the breakpoint set at the cursor-selected address in the Source 
window. 

This command is only applicable to lines that contain "BP" markers (which 
indicate set breakpoints) . Once the breakpoint is deleted, the original 
instruction is replaced. 

Command File Command 

BP DEL(ETE) address 

See Also 

"To delete a single breakpoint" in the "Using Breakpoints and Break Macros' 
section of the "Debugging Programs" chapter. 

Breakpoint^Edit... (ALT, B, E) 



226 



Chapter 8: Menu BarCommands 
Breakpoint-^Set Macro... (ALT, B, M ) 



Breakpoint->Set Macro... (ALT, B, M) 

Sets a break macro immediately before the cursor-selected address in the 
Source window. 

Break macro lines are marked with the "BP" breakpoint marker, and the 
corresponding addresses or line numbers are displayed in decimal format. 

When a break macro is hit, program execution stops immediately before 
executing the instruction or source code line at which the break macro is set. 
Then, the commands associated with the break macro are executed. When a 
"RUN" command is set as the last command in the break macro, the system 
executes the break macro and resumes program execution. 

The break macro remains active until it is deleted with the 

Breakpoint— ^Delete Macro (ALT, B, L) command or the Breakpoint— >Edit... 

(ALT, B, E) command. 

Because break macros use breakpoints, they cannot be set at addresses in 
target system ROM. 

Additional commands can be added to existing break macros as follows: 

• When a source code line or disassembled instruction is cursor-selected, 
the additional command is inserted at the top of the list of commands. 

• When a macro command line is cursor-selected, the additional command 
is inserted immediately following the cursor-selected command. 
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Breakpoint-^Set Macro... (ALT, B, M ) 



Break Macro Entry Dialog Box 

Choosing the Breakpoint— >Set Macro... (ALT, B, M) command opens the 
following dialog box: 



Set 

Breakpoint Address: |sample\\tt00033.1 
[X] Add Macro 

Macro Command: I EVALUATE "mes 



□ Global Disable and Delete All 



Current Breakpornts 
















Delete | Delete All j 







Close 



Breakpoint Specify line number or address followed by a decimal point 

Address and the break macro line number. 



Add Macro 



Macro 
Command 



When selected, this specifies that a break macro should be 
included with the breakpoint. 

Specifies the command to be added to the break macro. 



Set 



Sets the specified macro command at the location 
immediately preceding the specified source line or address, 
or sets the macro command at the location immediately 
following the specified break macro line. 

Two or more commands can be associated with a break 
macro by entering the first command and choosing {\b0 
Set}, then entering the second command and choosing {\b0 
Set}, and so on. Commands execute in the order of their 
entry. 
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Global Disable Disable and delete all current breakpoints and break 
and Delete All macros. 

Current Displays the addresses and line numbers of the current 

Breakpoints breakpoints and break macros. Allows you to select the 
breakpoints or break macros to be deleted. 

Enable/Disable Enable/Disable the selected breakpoint and break macro. 



Delete 



Delete All 



Close 



Deletes the selected breakpoints or break macros from the 
Breakpoints Set list box. Breakpoints or break macros are 
not actually deleted until the OK button is chosen. 

Deletes all the breakpoints and break macros from the 
Breakpoints Set list box. Breakpoints and break macros 
are not actually deleted until the OK button is chosen. 

Closes the dialog box. 



Command File Command 

BM SET address command 



See Also 

"To set a break macro" in the "Using Breakpoints and Break Macros" section 
of the "Debugging Programs" chapter. 
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Breakpoint^Delete Macro (ALT, B, L) 

Removes the break macro set at the cursor-indicated address in the Source 
window. 

This command is only applicable to lines that contain "BP" markers (which 
indicate set breakpoints) or break macro lines. 

When a source code line is cursor-selected, this command removes the 
breakpoint and all the macros commands set at the line. 

When a break macro line is cursor-selected, this command removes the single 
macro command at the line. 

Command File Command 

BM DEL (ETE) address 

See Also 

"To delete a single break macro" in the "Using Breakpoints and Break Macros" 
section of the "Debugging Programs" chapter. 

Breakpoint^Edit... (ALT, B, E) 
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Breakpoint^Edit... (ALT, B, E) 

Lets you set, list, or delete breakpoints and break macros. 



Breakpoint Dialog Box 

Choosing the Breakpoint— >Edit... (ALT, B, E) command opens the following 
dialog box: 



ireakpoint Edit 



Set 

Breakpoint Addiess: 
□ Add Macio 

Macro Command: 



sample\\«M)002 



□ Global Disable and Delete All 
Current Breakpoints — 



EN 000804d sample\\»0033 (EVALUATE - mes) 
EN 0008085 sample\\tt0042 



Enable/pisable J Delete | Delete All J 



Close 



Help j 



Breakpoint Specify line number or address followed by a decimal point 
Address and the break macro line number. 



Add Macro 



Macro 
Command 



When selected, this specifies that a break macro should be 
included with the breakpoint. 

Specifies the command to be added to the break macro. 



Set 



Sets the specified macro command at the location 
immediately preceding the specified source line or address, 
or sets the macro command at the location immediately 
following the specified break macro line. 
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Breakpoint-^Edit... (ALT, B, E) 



Global Disable 
and Delete All 



Two or more commands can be associated with a break 
macro by entering the first command and choosing {\b0 
Set}, then entering the second command and choosing {\b0 
Set}, and so on. Commands execute in the order of their 
entry. 

Disable and delete all current breakpoints and break 
macros. 



Current Displays the addresses and line numbers of the current 

Breakpoints breakpoints and break macros. Allows you to select the 
breakpoints or break macros to be deleted. 

Enable/Disable Enable/Disable the selected breakpoint and break macro. 

Delete Deletes the selected breakpoints or break macros from the 

Breakpoints Set list box. Breakpoints or break macros are 
not actually deleted until the OK button is chosen. 

Delete All Deletes all the breakpoints and break macros from the 

Breakpoints Set list box. Breakpoints and break macros 
are not actually deleted until the OK button is chosen. 

Close Closes the dialog box. 

Command File Command 

BP ENA(BLE) address 

BP DIS (ABLE ) address 
BP DEL (ETE ) address 
BP DEL (ETE) ALL 



See Also 

"To disable a breakpoint" and 

"To list the breakpoints and break macros" in the "Using Breakpoints and 
Break Macros" section of the "Debugging Programs" chapter. 
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Variable^Edit... (ALT, V, E) 

Displays or modifies the contents of the specified variable or copies it to the 
WatchPoint window. 

A dynamic variable can be registered as a watchpoint when the current 
program counter is in the function in which the variable is declared. If the 
program counter is not in this function, the variable name is invalid and an 
error results. 



Variable Edit Dialog Box 

Choosing the Variable— >Edit... (ALT, V, E) command opens the following 
dialog box: 



Variable Edit 



Variable: 



Close 



Tjipe: unsigned char 
r Value 



72 (48H) "H" 




♦J 










:]■» 


— i 



| Update | [ Modify... | to WP | 



Variable Specifies the name of the variable to be displayed or 

modified. The contents of the clipboard, usually a variable 
selected from the another window, automatically appears 
in this text box. 

Type Displays the type of the specified variable. 

Value Displays the contents of the specified variable. 
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Variable^Edit... (ALT, V, E) 



Update 



Reads and displays the contents of the variable specified in 
the Variable text box. 



Modify 



Modifies the contents of the specified variable. Choosing 
this button opens the Variable Modify Dialog Box, which 
lets you edit the contents of the variable. 



to WP 



Adds the specified variable to the WatchPoint window. 



Close 



Closes the dialog box. 



Command File Command 

VARI (ABLE ) variable TO data 

Replaces the contents of the specified variable with the specified value. 
See Also 

"To display a variable" and 

"To monitor a variable in the WatchPoint window" in the "Displaying and 
Editing Variables" section of the "Debugging Programs" chapter. 

"Symbols" in the "Expressions in Commands" chapter. 
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Variable Modify Dialog Box 



Variable Modify Dialog Box 

Choosing the Modify button in the Variable Edit dialog box opens the 
following dialog box, where you enter the new value and choose the OK 
button to confirm the new value. 



Variable Modify 


Variable: "mes 

Type: unsigned char 


□ K 
Cancel 




Value: 41 1 








Help | 



Variable Shows the variable to be edited. 

Type Indicates the type of the variable displayed in the Variable 

field. 

Value Lets you enter the new value of the variable. 

OK Replaces the contents of the specified variable with the 

specified value and closes the dialog box. 

Cancel Cancels the command and closes the dialog box. 



See Also 

"To edit a variable" in the "Displaying and Editing Variables" section of the 
"Debugging Programs" chapter. 
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Trace^Function Flow (ALT, T, F) 

Traces function flow by storing function entry points in the trace buffer. 

Assembly language functions can also be traced provided that they comply 
with C function call conventions. 

Note When you compile empty functions using icc7700 or nc77, stack frame is not 

made and you can't trace function flow correctly. 



Command File Command 

TRA(CE) FUN(CTION) FLO (W) 

See Also 

"To trace function flow" in the "Tracing Program Execution" section of the 
"Debugging Programs" chapter. 
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Trace^Function Caller... (ALT, T, C) 

Traces the caller of the specified function. 

The function name can be selected from another window (in other words, 
copied to the clipboard) before choosing the command; it will automatically 
appear in the dialog box that is opened. 

The analyzer stores only the execution of the function entry point and 
prestores execution states that occur before the function entry point. These 
prestored states correspond to the function call statements and identify the 
caller of the function. 

When assembly language programs are used, you can specify the assembler 
symbol for a subroutine instead of a C function name, and the prestored 
states will show the instructions that called the subroutine. 

Function Caller Trace Dialog Box 

Choosing the Trace— ^Function Caller... (ALT, T, C) command opens the 
following dialog box: 



|5J Function Caller Trace 


Function: 


OK | 


||next_messagefl 


Cancel j 




Help | 



Function Lets you enter the function whose callers you want to trace. 

OK Executes the command and closes the dialog box. 

Cancel Cancels the command and closes the dialog box. 

Command File Command 

TRA(CE) FUNC(TION) CAL (L) address 
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Trace-Function Caller... (ALT, T, C) 

See Also 

"To trace callers of a specified function" in the "Tracing Program Execution' 
section of the "Debugging Programs" chapter. 
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Trace^Function Statement... (ALT, T, S) 

Traces execution within the specified function. 

The function name can be selected from the another window (in other words, 
copied to the clipboard) before choosing the command; it will automatically 
appear in the dialog box that is opened. 

The analyzer stores execution states in the function's address range. 

Because the analyzer is set up based on function information from the object 
file, this command cannot be used to trace non-C functions. 

Function Statement Trace Dialog Box 

Choosing the Trace— ^Function Statement... (ALT, T, S) command opens the 
following dialog box: 



Q Function Statement Trace 


Function: 


OK 




Mlm.'xt messaqe^BBMililiijiMMMtfi 


Cancel 







Function Lets you enter the function whose execution you want to 

trace. 

OK Traces within the specified function and closes the dialog 

box. 

Cancel Cancels the command and closes the dialog box. 

Command File Command 

TRA(CE) FUNC(TION) STA (TEMENT) address 
See Also 

"To trace execution within a specified function" in the "Tracing Program 
Execution" section of the "Debugging Programs" chapter. 
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Trace^Variable Access... (ALT, T, V) 

Traces accesses to the specified variable. 

The variable name can be selected from another window (in other words, 
copied to the clipboard) before choosing the command; it will automatically 
appear in the dialog box that is opened. 

You can specify any of the external or static variables, or the variables having 
a fixed address throughout the course of program execution. 

The analyzer stores only accesses within the range of the variable and 
prestores execution states that occur before the access. These prestored 
states correspond to the statements that access the variable. 

Variable Access Dialog Box 

Choosing the Trace— ¥ Variable Access... (ALT, T, V) command opens the 
following dialog box: 



E5 Variable Access Trace 


Variable: 


OK | 


||message id| 


Cancel :j 




Help | 



Variable Lets you enter the variable name. 

OK Traces accesses to the specified variable and closes the 

dialog box. 

Cancel Cancels the command and closes the dialog box. 

Command File Command 

TRA(CE) VAR(IABLE) ACC(ESS) address 
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Trace-A/ariable Access... (ALT, T, V) 

See Also 

"To trace accesses to a specified variable" in the "Tracing Program Execution" 
section of the "Debugging Programs" chapter. 
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Trace^Variable Break... (ALT, T, B) 

Traces before, and breaks program execution when, a value is written to a 
variable. 

The variable name can be selected from another window (in other words, 
copied to the clipboard) before choosing the command; it will automatically 
appear in the dialog box that is opened. 

You can specify any of the external or static variables, or the variables having 
a fixed address throughout the course of program execution. 

Variable Break Dialog Box 

Choosing the Trace— > Variable Break... (ALT, T, B) command opens the 
following dialog box: 



^ Variable Break Trace 


Variable: 


OK | 




message_id 


Cancel 


Value: 


Help 


|o | 





Variable Lets you enter the variable name. 

Value Lets you enter the value that, when written to the variable, 

triggers the analyzer. 

OK Starts the trace and closes the dialog box. 

Cancel Cancels the command and closes the dialog box. 

Command File Command 

TRA(CE) VAR(IABLE) BRE (AK) address data 
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Tracer-Variable Break... (ALT, T, B) 

See Also 

"To trace before a particular variable value and break" in the "Tracing 
Program Execution" section of the "Debugging Programs" chapter. 
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Trace— »Edit... (ALT.T, E) 



Trace^Edit... (ALT, T, E) 

Edits the trace specification of the last trace command. 

This command is useful for making modifications to the last entered trace 
command, even if the analyzer was setup automatically as with the 
Trace— ^Function or Trace— > Variable commands. 

Trace specifications are edited with Sequence Trace Setting dialog box. 

Command File Command 

TRA(CE) SAV(E) filename 

Stores the current trace specification to a file. 

TRA(CE) LOA(D) filename 
Loads the specified trace setting file. 

TRA(CE) CUS(TOMIZE) 

Traces program execution using the loaded trace setting file. 
See Also 

"To edit a trace specification" in the "Setting Up Custom Trace Specifications" 
section of the "Debugging Programs" chapter. 

Trace-Sequence... (ALT, T, Q) 
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Trace^Trigger Store... (ALT, T, T) 

Traces program execution as specified in the Trigger Store Trace dialog box. 

You can enter address, data, and status values that qualify the state (s) that, 
when captured by the analyzer, will be stored in the trace buffer or will 
trigger the analyzer. 

Data values are 16-bit values (because the data bus is 16 bits wide). To 
identify byte values on the data bus, use "don't cares" as shown below: 

Data at an even address: 0xx34 

Data at an odd address: 12xx 

Status values identify the types of microprocessor bus cycles. You may 
select status values from a predefined list. 



Trigger Store Trace Dialog Box 

Choosing the Trace— ^Trigger Store... (ALT, T, T) command opens the 
following dialog box: 



Trigger Store Trace 



Tiiggei' 
□ SNOT 



Addiess 



Data 



Status 



End Addiess 



® tiiggei start O tiiggei centei O trigger end 



Stoie 
□ NOT 



Address 



Data 



Status 



End Addiess 



□ K 



Cancel 



Clear 



Save ~j 



Help J 



Trigger 



This box groups the items that make up the trigger 
condition. 
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Tracer-Trigger Store... (ALT, T, T) 

NOT 

Address 
End Address 
Data 
Status 
trigger start 

trigger center 

trigger end 

Store 
OK 

Cancel 

Clear 

Load... 

Save... 



Specifies any state that does not match the Address, Data, 
and Status values. 

Specifies the address portion of the state qualifier. 

Specifies the end address of an address range. 

Specifies the data portion of the state qualifier. 

Specifies the status portion of the state qualifier. 

Specifies that states captured after the trigger condition be 
stored in the trace buffer. 

Specifies that states captured before and after the trigger 
condition be stored in the trace buffer. 

Specifies that states captured before the trigger condition 
be stored in the trace buffer. 

This box groups the items that make up the store condition. 

Starts the specified trace and closes the dialog box. 

Cancels the trace setting and closes the dialog box. 

Restores the dialog box to its default state. 

Opens a file selection dialog box from which you select the 
name of a trace specification file previously saved from the 
Trigger Store Trace dialog box. Trace specification files 
have the extension ".TRC". 

Opens a file selection dialog box from which you select the 
name of the trace specification file. 
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Trace->Trigger Store... (ALT, T, T) 



Command File Command 

TRA(CE) LOA(D) filename 
Loads the specified trace setting file. 

TRA(CE) CUS(TOMIZE) 

Traces program execution using the loaded trace setting file. 
See Also 

"To set up a 'Trigger Store' trace specification" in the "Setting Up Custom 
Trace Specifications" section of the "Debugging Programs" chapter. 
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Trace^Find Then Trigger... (ALT, T, D) 

Traces program execution as specified in the Find Then Trigger Trace dialog 
box. 

This command lets you set up a two level sequential trace specification that 
works like this: 

1 Once the trace starts, the analyzer stores (in the trace buffer) the states 
that satisfy the Enable Store condition while searching for a state that 
satisfies the Enable condition. 

2 After the Enable condition has been found, the analyzer stores the states 
that satisfy the Trigger Store condition while searching for a state that 
satisfies the Trigger condition. 

3 After the Trigger condition has been found, the analyzer stores the states 
that satisfy the Store condition. 

If any state during the sequence satisfies the Restart condition, the sequence 
starts over. 

You can enter address, data, and status values that qualify state (s) by setting 
up pattern or range resources. These patterns and range resources are used 
when defining the various conditions. 
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Trace— >Find Then Trigger... (ALT, T, D) 



Find Then Trigger Trace Dialog Box 



Choosing the Trace— >Find Then Trigger... (ALT, T, D) command opens the 
following dialog box: 



Sequence 
Enable Store: 

Enable: 
Trigger Stoie: 

Trigger: 
Store: 



Find then Trigger Trace 



any state 



any state 



any state 



any state 



any state 



Restart: 

Count: 

Prestore: 



no state 



trigger start 
o trigger center 
O trigger end 
n Break on Trigger 



OK 



Cancel 



Clear 



Load.. 



Sa ve. . 



Pattern/Range: (Select with:Return/DblClick) 


Help J 


a = A: D: S: 




b = A: D: S: 




c = A: D: S: 




d = A: D: S: 




e = A D: S: 





The Sequence group box specifies a two term sequential trigger condition. It 
also lets you specify store conditions during the sequence. 

Enable Store Qualifies the states that get stored (in the trace buffer) 
while searching for a state that satisfies the enable 
condition. 



Enable 



Specifies the condition that causes a transfer to the next 
sequence level. 



Trigger Store Qualifies the states that get stored while the analyzer 
searches for the trigger condition. 



Trigger 
Store 



Specifies the trigger condition. 

Qualifies the states that get stored after the trigger 
condition is found. 



Restart 



Specifies the condition that restarts the sequence. 
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Trace— >Find Then Trigger... (ALT, T, D) 



Count Specifies whether time or the occurrences of a particular 

state are counted; you can also turn counts OFF. See the 
Condition Dialog Boxes. 

Prestore Qualifies the states that may be stored before each 

normally stored state. Up to two states may be prestored 
for each normally stored state. Prestored states can be 
used to show from where a function is called or a variable 
is accessed. 



trigger start The state that satisfies trigger condition is positioned at 
the start of the trace, and states that satisfy the Store 
condition will be stored after the trigger. In this case, the 
states that satisfy the Enable Store and Trigger Store 
conditions will not appear in the trace. 

trigger center The state that satisfies the trigger condition is positioned in 
the center of the trace, and states that satisfy the store 
conditions will be stored before and after the trigger. 

trigger end The state that satisfies the trigger condition is positioned 
at the end of the trace, and states that satisfy the Enable 
Store and Trigger Store conditions will be stored before the 
trigger. In this case, states that satisfy the Store condition 
will not appear in the trace. 

Break on When selected, this option specifies that execution break 

Trigger into the monitor when the analyzer is triggered. 

Pattern/Range Specifies the trace patterns for the state conditions. 

Double-clicking the desired pattern in the Pattern/Range 
list box opens the Trace Pattern Dialog Box or the Trace 
Range Dialog Box, where you specify the desired trace 
pattern or range. 

Clicking the Sequence, Restart, Count, or Prestore buttons 
causes the Condition Dialog Boxes to be opened. This 
dialog box lets you select or combine patterns or ranges to 
specify the condition. 
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Trace— >Find Then Trigger... (ALT, T, D) 



OK Starts the specified trace and closes the dialog box. 

Cancel Cancels trace setting and closes the dialog box. 

Clear Restores the dialog box to its default state. 

Load... Opens a file selection dialog box from which you select the 

name of a trace specification file previously saved from the 
Trigger Store Trace or Find Then Trigger Trace dialog 
boxes. Trace specification files have the extension ".TRC". 

Save... Opens a file selection dialog box from which you select the 

name of the trace specification file. 

Command File Command 

TRA(CE) LOA(D) filename 
Loads the specified trace setting file. 

TRA(CE) CUS(TOMIZE) 

Traces program execution using the loaded trace setting file. 
See Also 

"To set up a 'Find Then Trigger' trace specification" in the "Setting Up 
Custom Trace Specifications" section of the "Debugging Programs" chapter. 
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Trace^Sequence... (ALT, T, Q) 

Traces program execution as specified in the Sequence Trace dialog box. 

This command lets you set up a multi-level sequential trace specification that 
works like this: 

1 Once the trace starts, the analyzer stays on sequence level 1 until the 
primary or secondary branch condition is found. (If a state satisfies both 
primary and secondary branch conditions, the primary branch is taken.) 
Once the primary or secondary branch condition is found, the analyzer 
transfers to the sequence level specified by the "to" button. 

2 The analyzer stays at the next sequence level until its primary or 
secondary branch condition is met; then, the analyzer transfers to the 
sequence level specified by the "to" button. 

3 When the analyzer reaches the sequence level specified in Trigger On, 
the analyzer is triggered. 

4 During the above described operation, the analyzer stores the states 
specified in the Store text box. 



252 



Chapter 8: Menu BarCommands 
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Sequence Trace Dialog Box 

Choosing the Trace-^Sequence... (ALT, T, Q) command opens the following 
dialog box: 



Sequence Trace 



Pattern/Range: (Select with:Retum/DblClick) 

a = A: D: S: 
b = A: D: S: 
c = A: D: S: 
d = A: D: S: 
= A: D: S: 



Primary Secondary 
Branch: to Branch: to 


Page 


Store: 


any state j 2 j 


no state | 1 j 


any state 


any^ state | 3 j 


no state j 1 j 


any state | 


any state j 4 j 


no state j 1 j 


any state 


any state j 5 j 


no state ' 1 j 


any state ! 



Tiiggei On: 
Count: 



<S> trigger start 
O trigger center 
O trigger end 
□ Break on Trigger 



OK 



Cancel 



] I as 1 

1 ■»■"' 1 

Save..~| 



Help 



The Sequence group box specifies two types of branch conditions for 
transferring from one sequence level to another. It also specifies store 
conditions for each of sequence levels 1 through 8. 

Primary Branch Specifies the condition for transferring to the sequence 
level specified in the "to" text box. 



Secondary Specifies the condition for transferring to the sequence 

Branch level specified in the "to" text box. Secondary branches are 

used to do things like restart the sequence if a particular 

state is found. 



Store Specifies the states stored in the trace buffer at each 

sequence level. 

Page Toggles the display between sequence levels 1 through 4 

and levels 5 through 8. 



Trigger On Specifies the sequence level whose entry triggers the 

analyzer. See the Sequence Number Dialog Box. 
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Trace-Sequence... (ALT, T, Q) 



Count Specifies whether time or the occurrences of a particular 

state are counted; you can also turn counts OFF. See the 
Condition Dialog Boxes. 

Prestore Qualifies the states that may be stored before each 

normally stored state. Up to two states may be prestored 
for each normally stored state. Prestored states can be 
used to show from where a function is called or a variable 
is accessed. 



trigger start 



trigger center 



trigger end 



Break on 
Trigger 

Pattern/Range 



OK 

Cancel 



The state that satisfies trigger condition is positioned at 
the start of the trace, and states that satisfy the store 
conditions will be stored after the trigger. 

The state that satisfies the trigger condition is positioned in 
the center of the trace, and states that satisfy the store 
conditions will be stored before and after the trigger. 

The state that satisfies the trigger condition is positioned 
at the end of the trace, and states that satisfy the store 
conditions will be stored before the trigger. 

When selected, this option specifies that execution break 
into the monitor when the analyzer is triggered. 

Specifies the trace patterns for the state conditions. 
Double-clicking the desired pattern in the Pattern/Range 
list box opens the Trace Pattern Dialog Box or the Trace 
Range Dialog Box, where you specify the desired trace 
pattern or range. 

Clicking the Primary Branch, Secondary Branch, Store, 
Count, or Prestore buttons causes the Condition Dialog 
Boxes to be opened. This dialog box lets you select or 
combine patterns or ranges to specify the condition. 

Starts the specified trace and closes the dialog box. 

Cancels trace setting and closes the dialog box. 
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Trace-Sequence... (ALT, T, Q) 

Clear Restores the dialog box to its default state. 

Load... Opens a file selection dialog box from which you select the 

name of a trace specification file previously saved from any 
of the trace setting dialog boxes. Trace specification files 
have the extension ".TRC". 

Save... Opens a file selection dialog box from which you select the 

name of the trace specification file. 

Command File Command 

TRA(CE) LOA(D) filename 
Loads the specified trace setting file. 

TRA(CE) CUS(TOMIZE) 

Traces program execution using the loaded trace setting file. 
See Also 

"To set up a 'Sequence' trace specification" in the "Setting Up Custom Trace 
Specifications" section of the "Debugging Programs" chapter. 
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Trace^UntilHalt (ALT, T, U) 



Trace^Until Halt (ALT, T, U) 

Traces program execution until the Trace— >Halt (ALT, T, H) command is 
chosen. 

This command is useful in tracing execution that leads to a processor halt or 
a break to the background monitor. Before executing the program, choose 
the Trace— >Until Halt (ALT, T, U) command. Then, run the program. After 
the processor has halted or broken into the background monitor, choose the 
Trace— >Halt (ALT, T, H) command to stop the trace. The execution that led 
up to the break or halt will be displayed. 

Command File Command 

TRA(CE) ALW(AYS) 

See Also 

"To trace until the command is halted" in the "Tracing Program Execution" 
section of the "Debugging Programs" chapter. 
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Trace->Halt(ALT, T, H) 



Trace^Halt (ALT, T, H) 

Stops a running trace. 

This command stops a currently running trace whether the trace was started 
with the Trace— >Until Halt (ALT, T, U) command or another trace command. 

As soon as the analyzer stops the trace, stored states are displayed in the 
Trace window. 

Command File Command 

TRA(CE) STO(P) 

See Also 

"To stop a running trace" in the "Tracing Program Execution" section of the 
"Debugging Programs" chapter. 
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Trace^Again (F7), (ALT, T, A) 



Trace^Again (FT), (ALT, T, A) 

Traces program execution using the last trace specification stored in the HP 
64700. 

If you haven't entered a trace command since you started the debugger, the 
last trace specification stored in the HP 64700 may be a trace specification 
set up by a different user; in this case, you cannot view or edit the trace 
specification. 

Command File Command 

TRA(CE) AGA(IN) 

See Also 

"To repeat the last trace" in the "Tracing Program Execution" section of the 
"Debugging Programs" chapter. 
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Condition Dialog Boxes 

Choosing the buttons associated with enable, trigger, primary branch, 
secondary branch, store, or prestore conditions opens the following dialog 
box: 



Trace Condition 



any state □ no state 



state 
setl 



□ a □ b □ c 
Dd D lange 

□ not range 

Oor Onoi 



□ OR 

□ and 



set2 

□ e Ql Qg 

□ h □aim 

O or O nor 



Count 



OK 



Cancel [ 



Help 



Choosing the button associated with the count condition opens the following 
dialog box: 



Count Condition 



□ any state □ no state 



state 

"setl 

□ a Db Dc 
3 d □ range 

□ not range 

O or O nor 



O OR 



n 



AND 



set2 

□ e □ . Dg 

□ h □ aim 

O or O not 



OK 



Cancel 



Help | 



no state No state meets the specified condition. 

any state Any state meets the specified condition. 

time The analyzer counts time for each state stored in the trace. 
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Condition Dialog Boxes 



state 



This group box lets you qualify the state that will meet the 
specified condition. You can qualify the state as one of the 
patterns "a" through "h", the "range", or the "arm", or you 
can qualify the state as a combination of the patterns, 
range, or arm by using the interset or intraset operators. 



abcdefgh The patterns that qualify states by identifying the 

address, data, and/or status values. 

The values for a pattern are specified by selecting one 
of the patterns in the Pattern/Range list box and 
entering values in the Trace Pattern Dialog Box. 



range 



Identifies a range of address or data values. 



The values for a range are specified by selecting the 
range in the Pattern/Range list box and entering values 
in the Trace Range Dialog Box. 



not range 
arm 



Identifies all values not in the specified range. 

Identifies the condition that arms (in other words, 
activates) the analyzer. The analyzer can be armed by 
an input signal on the BNC port. 



or/nor 



You can combine patterns within the setl or set2 
group boxes with these logical operators. 



You can create the AND and NAND operators by 
selecting NOT when defining patterns and applying 
DeMorgan's law (the / character is used to represent a 
logical NOT): 



W1AND A and B 

NAND / (A and B) = 



/ (/A or /B) NOR 
/A or /B OR 



OR/AND 



You can combine patterns from the setl and set2 
group boxes with these logical operators. 
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Condition Dialog Boxes 



Count 



Appearing in Trace Condition dialog boxes, this value 
specifies the number of occurrences of the state that 
will satisfy the condition. 



OK 



Applies the state qualifier to the specified condition and 
closes the dialog box. 



Cancel 



Closes the dialog box. 



See Also 

"To set up a 'Find Then Trigger' trace specification" and 

"To set up a 'Sequence' trace specification" in the "Setting Up Custom Trace 

Specifications" section of the "Debugging Programs" chapter. 

Trace^Find Then Trigger... (ALT, T, D) 
Trace->Sequence... (ALT, T, Q) 



261 



Chapter 8: Menu BarCommands 
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Trace Pattern Dialog Box 



Selecting one of the patterns in the Pattern/Range list box opens the 
following dialog box: 



□ UPt 
Address: 
Data: 
Status: 



□ Direct: 



Trace Pattern 




bg 


dmawrite 


word 


byte 


exec 


write 


cpu 


fetch 




data 


fg 




dataread 


hold 




datawrite 
dma 

dmaread 


mx 

read 

ref 





Help 



NOT Lets you specify all values other than the address, data, 

and/or status values specified. 

Address Lets you enter the address value for the pattern. 

Data Lets you enter the data value for the pattern. 

Status Lets you select the status value for the pattern. 

Direct Lets you enter a status value other than one of the 

predefined status values. 

Clear Clears the values specified for the pattern. 

OK Applies the values specified for the pattern, and closes the 

dialog box. 
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Trace Pattern Dialog Box 



Cancel Closes the dialog box. 

See Also 

"To set up a 'Find Then Trigger' trace specification" and 

"To set up a 'Sequence' trace specification" in the "Setting Up Custom Trace 

Specifications" section of the "Debugging Programs" chapter. 

Trace^Find Then Trigger... (ALT, T, D) 
Trace->Sequence... (ALT, T, Q) 
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Trace Range Dialog Box 

Selecting the range in the Pattern/Range list box opens the following dialog 
box: 



Trace Range 



"Bus 

<§> Addr. 
O Data 



Minimum: 



Maximum: 



Address Selects a range of address values. 

Data Selects a range of data values. 

Minimum Lets you enter the minimum value for the range. 

Maximum Lets you enter the maximum value for the range. 

OK Applies the values specified for the range, and closes the 
dialog box. 

Cancel Closes the dialog box. 

Clear Clears the values specified for the range. 



essi 



OK 



Cancel 



Clear | 
Help 1 
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Trace Range Dialog Box 

See Also 

"To set up a 'Find Then Trigger' trace specification" and 

"To set up a 'Sequence' trace specification" in the "Setting Up Custom Trace 

Specifications" section of the "Debugging Programs" chapter. 

Trace^Find Then Trigger... (ALT, T, D) 
Trace-Sequence... (ALT, T, Q) 
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Sequence Number Dialog Box 

Choosing the buttons associated with "to" or Trigger On opens the following 
dialog box: 



f^j Sequence Number 


OS O 5 
<S> 2 O 6 

03 07 

04 OS 


OK 
Cancel J 

Help | 



1-8 These options specify the sequence level. 

OK Applies the selected sequence level and closes the dialog 

box. 

Cancel Closes the dialog box. 

See Also 

"To set up a 'Sequence' trace specification" in the "Setting Up Custom Trace 
Specifications" section of the "Debugging Programs" chapter. 

Trace->Sequence... (ALT, T, Q) 
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RealTime^Monitor Intrusion^Disallowed (ALT, R, 

T, D) 

Activates the real-time mode. 

When the user program is running in real-time mode, no command that 
would normally cause temporary suspension of program execution is allowed. 
Also, the system hides: 

• The Register window. 

• Target system memory in the Memory window. 

• Target system I/O locations in the I/O window. 

• Target system memory variables in the WatchPoint window. 

• Target system memory in the Source window. 

While the processor is in the RUNNING REALTIME IN USER PROGRAM 
state, no display or modification is allowed for the contents of target system 
memory or registers. Therefore, before you can display or modify target 
system memory or processor registers, you must use the Execution— >Break 
(ALT, E, B) command to stop user program execution and break into the 
monitor. 

Command File Command 

MOD (E ) REA(LTIME) ON 

See Also 

"To allow or deny monitor intrusion" in the "Setting the Real-Time Options" 
section of the "Configuring the Emulator" chapter. 
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RealTime->M onitor Intrusion— ^Allowed (ALT, R, T, A) 



RealTimesMonitor Intrusions Allowed (ALT, R, T, A) 

Deactivates the real-time mode. 

Commands that cause temporary breaks to the monitor during program 
execution are allowed. 

Command File Command 

MOD (E ) REA(LTIME) OFF 

See Also 

"To allow or deny monitor intrusion" in the "Setting the Real-Time Options" 
section of the "Configuring the Emulator" chapter. 
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RealTime^l/O Polling^ON (ALT, R, 1, 0) 



RealTime^I/O Polling^ON (ALT, R, I, O) 

Enables access to I/O. 

Command File Command 

MOD (E ) IOG(UARD) OFF 

See Also 

"To turn polling ON or OFF" in the "Setting the Real-Time Options" section of 
the "Configuring the Emulator" chapter. 



269 



Chapter 8: Menu BarCommands 
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RealTime^I/O Polling^OFF (ALT, R, I, F) 

Disables access to I/O. 

When polling is turned OFF, values in the I/O window are updated on entry to 
the monitor. When monitor intrusion is not allowed during program 
execution, the I/O window is not updated and contents are replaced by 
dashes (-). 

Command File Command 

MOD (E ) IOG(UARD) ON 

See Also 

"To turn polling ON or OFF" in the "Setting the Real-Time Options" section of 
the "Configuring the Emulator" chapter. 



270 



Chapter 8: Menu BarCommands 
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RealTime^Watchpoint Polling^ON (ALT, R, W, O) 

Turns ON polling to update values displayed in the WatchPoint window. 

When polling is turned ON, temporary breaks in program execution occur 
when the WatchPoint window is updated. 

Command File Command 

MOD (E ) WAT(CHPOLL) ON 

See Also 

"To turn polling ON or OFF" in the "Setting the Real-Time Options" section of 
the "Configuring the Emulator" chapter. 
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RealTime^Watchpoint Polling^OFF (ALT, R, W, F) 

Turns OFF polling to update values displayed in the WatchPoint window. 

When polling is turned OFF, values in the WatchPoint window are updated 
on entry to the monitor. When monitor intrusion is not allowed during 
program execution, the WatchPoint window is not updated and contents are 
replaced by dashes (-). 

Command File Command 

MOD (E) WAT(CHPOLL) OFF 

See Also 

"To turn polling ON or OFF" in the "Setting the Real-Time Options" section of 
the "Configuring the Emulator" chapter. 
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RealTime->M emory Polling->ON (ALT, R, M , 0) 



RealTime^Memory Polling^ON (ALT, R, M, O) 

Turns ON polling to update target memory values displayed in the Memory 
window. 

When polling is turned ON, temporary breaks in program execution occur 
when target system memory locations in the Memory window are updated. 
When monitor intrusion is not allowed during program execution, the 
contents of target memory locations are replaced by dashes (-) . 

Also, when polling is turned ON, you can modify the addresses displayed or 
contents of memory locations by double-clicking on the address or value, 
using the keyboard to type in the new address or value, and pressing the 
Return key. 

Command File Command 

MOD (E) MEM (ORYPOLL) ON 

See Also 

"To turn polling ON or OFF" in the "Setting the Real-Time Options" section of 
the "Configuring the Emulator" chapter. 
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RealTime->M emory Polling->OFF (ALT, R, M , F) 



RealTime^Memory Polling^OFF (ALT, R, M, F) 

Turns OFF polling to update target memory values displayed in the Memory 
window. 

When polling is turned OFF, values in the Memory window are updated on 
entry to the monitor. 

Also, when polling is turned OFF, you cannot modify the addresses displayed 
or contents of memory locations by double-clicking on the address or value. 

Command File Command 

MOD (E) MEM (ORYPOLL) OFF 

See Also 

"To turn polling ON or OFF" in the "Setting the Real-Time Options" section of 
the "Configuring the Emulator" chapter. 
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Assemble... (ALT, A) 



In-line assembler. 

This command lets you modify programs by specifying assembly language 
instructions which are assembled and loaded into program memory. 

Assembler Dialog Box 

Choosing the Assemble... (ALT, A) command opens the following dialog box: 




Address: 



Label: 



00080e0 



main 




Mnemonic: LDA A.04H.S 



Help | 



Label 



Lets you assign a user-defined symbol to the specified 
address. 



Address 



Lets you enter the address at which the assembly language 
instruction will be loaded. 



Mnemonic 



Lets you enter the assembly language instruction to be 
assembled. 



Assemble 



Assembles the instruction in the Mnemonic text box, and 
loads it into memory at the specified address. 



Close 



Closes the dialog box. 



Command File Command 



ASM address label "inst_string 



ii 
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Settings^Emulator Config^Hardware... (ALT, S, E, 
H) 

Specifies the emulator configuration. 
Hardware Config Dialog Box 

Choosing the Settings— ^Emulator Config— ^Hardware... (ALT, S, E, H) 
command opens the following dialog box: 



Hardware Config 



7702M2 



Clock Source 
Processor Type 

Processor Mode | single 

Enable High Speed Access 

introduce /RDY input 
Enable Watchdog Timer 
Enable Break on Write to ROM 
Processor Clock is Faster than 16MHz 



<§> Internal O External [ OK J 
□ L*l I Cancel | 



Apply 



□ 
□ 
□ 
□ 
□ 



Help | 



Tool Type" 



IAR O MRI O Mitsubishi 



Memory M odel 



O banked 



Clock Source Specifies Internal or External clock as the system clock. 

Processor Type Specifies the processor type. 

Processor Mode Specifies the mode of the processor. 

Enable High Enables or disables High Speed Access Mode. 
Speed Access 
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Introduce /RDY Enables or disables /RDY input when the emulator accesses 

input any memory. 

Enable Enables or disables the Watchdog Timer. 
Watchdog Timer 

Enable Break on Enables or disables breaks to the monitor when the user 

Write to ROM program writes to memory mapped as ROM. 

Processor Specifies whether time can be counted for states stored in 

Clock is Faster trace memory. Up to 16 MHz, time can be counted. Above 

Than 16 MHz 16 MHz, only the occurrences of qualified states can be 
counted. 

Tool Type Specifies tool type you use. 

Memory Medel Specifies memory model you use. 

OK Stores the current modification and closes the dialog box. 

Cancel Cancels the current modification and closes the dialog box. 

Apply Loads the configuration settings into the emulator. 

Command File Command 

CON (FIG) CLO(CK) INT (ERNAL) 
Selects the internal clock. 

CON (FIG) CLO(CK) EXT (ERNAL) 
Selects the external clock. 

CON (FIG) PRO(CESSOR) processor_name 
Selects the processor. 

CON (FIG) MOD (E) processor_mode 
Selects the processor mode. 

CON (FIG) HAC(CESS) EN (ABLE) 
Enables High Speed Access mode. 
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CON (FIG) HAC(CESS) DIS (ABLE) 
Disables High Speed Access mode. 

CON (FIG) REA(DY) EN (ABLE) 
Enables /RDY input when accesses memory. 

CON (FIG) REA(DY) DIS (ABLE) 
Disables /RDY input when accesses memory. 

CON (FIG) WAT (CHDOG) ENA(BLE) 
Enables the Watchdog Timer. 

CON (FIG) WAT (CHDOG) DIS (BLE) 
Disables the Watchdog Timer. 

CON (FIG) ROM (BREAK) EN (ABLE) 

Enables breaks to the monitor when writes to ROM occur. 

CON (FIG) ROM (BREAK) DIS (ABLE) 

Disables breaks to the monitor when writes to ROM occur. 

CON (FIG) SPE(ED) FAS (T) 

Specifies the clock speed is faster than 16 MHz. 

CON (FIG) SPE(ED) SLO (W) 

Specifies the clock speed is not faster than 16 MHz. Any of the above 
command file commands must be preceded and followed by the respective 
start and end commands: 

CON (FIG) TOO (LTYPE) IAR 
Specifies IAR language tool. 

CON (FIG) TOO (LTYPE) MRI 
Specifies MRI language tool. 

CON (FIG) TOO (LTYPE) MIT(SUBISHI) 
Specifies Mitsubishi language tool. 

CON (FIG) MEM (MODEL) SMA(LL) 
Specifies memory model small. 

CON (FIG) MEM (MODEL) MED(IUM) 
Specifies memory model medium. 
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CON (FIG) MEM (MODEL) COM (PACT) 
Specifies memory model compact. 

CON (FIG) MEM (MODEL) BAN (KED) 
Specifies memory model banked. 

CON (FIG) STA(RT) 

Starts the configuration option command section. 
CON (FIG) END 

Ends the configuration option command section. 
See Also 

"Setting the Hardware Options" in the "Configuring the Emulator" chapter. 
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Settings^Emulator Config^Memory Map... (ALT, S, 
E, M) 

Maps memory ranges. 

In the HP 64146/7 emulators, you can map up to 16 address ranges (map 
terms). The minimum amount of emulation memory that can be allocated to 
a range is 256 bytes. 

You can map ranges as emulation RAM, emulation ROM, target system RAM, 
target system ROM, or as guarded memory. 

Guarded memory accesses cause emulator execution to break into the 
monitor program. 

Writes to locations mapped as ROM will cause emulator execution to break 
into the monitor program if these breaks are enabled in the hardware 
configuration. 

Writes to emulation ROM are inhibited. However, even though user program 
writes to target system memory locations mapped as ROM or guarded 
memory may result in a break to the monitor, they are not inhibited (that is, 
the write still occurs) . 

When high speed access mode is enabled in the Hardware Configuration, you 
can map the emulation memory only to one location, depending on the 
monitor type and capacity of the memory board. 
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Memory Map Dialog Box 

Choosing the Settings-^Emulator Config->Memory Map... (ALT, S, E, M) 
command opens the following dialog box: 



Memory Map Config 



Define Map Term 

Start: || ~| 

End: | 

TTjppe 

<§> eram O eiom O tram 
O tiom O guarded 

I ^ Ply f 

"Default 

<S> tiam O tiom O guarded 



Start Specifies the starting address of the address range to be 

mapped. 

End Specifies the end address of the address range to be 

mapped. 

Type Lets you select the memory type of the specified address 

range. 

Apply Maps the address range specified in the Define Map Term 

group box. 

Default Specifies whether unmapped memory ranges are target 

system RAM, target system ROM, or guarded memory. 

Current Map Lists currently mapped ranges. 

Available Indicates the amount of emulation memory available. 

Delete Deletes the address range selected in the Current Map list 

box. 



281 



" Lurrent Map 




Available: 



446 Kbytes 
Belete { Delete All J 



Close 



Help 
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Delete All Deletes all of the address ranges in the Current Map list 

box. 

Close Closes the dialog box. 

Command File Command 

MAP address range mem_type 

Maps the specified address range with the specified memory type. 
MAP OTH(ER) mem_type 

Specifies the type of the specified non-mapped memory area. 

Any of the above command file commands must be preceded and followed by 
the respective start and end commands: 

MAP STA(RT) 

Starts the memory mapping command section. 
MAP END 

Ends the memory mapping command section. 
See Also 

"Mapping Memory" in the "Configuring the Emulator" chapter. 
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Settings->Emulator Config->Monitor... (ALT, S, E, O) 

Selects the type of monitor program and other monitor options. 
Monitor Config Dialog Box 

Choosing the Settings->Emulator Config->Monitor... (ALT, S, E, O) 
command opens the following dialog box: 



Monitor Config 



Background: 0 Foreground 



lype 

" S tack 

Reset Value for Stack Pointer 



NOTE: Must reset processor to take effect 



Foreground Settings " 
Monitor Addrsvv 



Monftor Name'. 



OK 



Cancel 



Apply 



Help 1 



NOTE: Must reset processor to cause load of monitor file 



Type 



Reset Value for 
Stack Pointer 



Lets you choose between a background monitor and a 
foreground monitor. 

Specifies the value the stack pointer is set to when the 
processor transfers from the EMULATION RESET status 
to the RUNNING IN MONITOR status. Both types of 
monitor programs require a stack to be set up in RAM. 



Monitor Address Specifies the starting address of the foreground monitor 

program. The foreground monitor program must be linked 
at this address. 
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When using the foreground monitor, the starting address 
must be located on a 2 Kbyte boundary in bankO except 
internal RAM area and SFR area. 

Monitor Name Lets you enter the name of the foreground monitor object 
file. The default is C:\HP\RTC\M7700\FGMON\FGMON.X 
(if C:\HP\RTC\M7700 was the installation path chosen 
when installing the debugger software). The foreground 
monitor will be automatically loaded after each 
Execution— >Reset (ALT, E, E) command. Choosing the 
Apply button does not load the foreground monitor. 

Browse... Opens a file selection dialog box from which you can select 

the foreground monitor object file to be loaded. 

OK Modifies the monitor configuration as specified and closes 

the dialog box. When you have selected a foreground 
monitor, it is not loaded when you choose OK; instead, you 
must load it using the File— >Load Object... (ALT, F, L) 
command. A foreground monitor will be loaded 
automatically after each Emulation— >Reset (ALT, E, E) 
command. 

Cancel Cancels the monitor configuration and closes the dialog 

box. 

Apply Loads the configuration settings into the emulator. 

Command File Command 

MON(ITOR) PRO (CESS) BAC (K) 
Selects the background monitor. 

MON(ITOR) PRO (CESS) FOR (E) 
Selects the foreground monitor. 

MON(ITOR) STA(CK) address 

Specifies the value the stack pointer is set to when the emulator breaks into 
the monitor from the EMULATION RESET status. 
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MON(ITOR) LOC (ATE) address 
Specifies the starting address of the monitor. 

MON(ITOR) FIL(ENAME) file_name 
Names the foreground monitor object file. 

Any of the above command file commands must be preceded and followed by 
the respective start and end commands: 

MON(ITOR) STA(RT) 

Starts the monitor option command section. 

MON(ITOR) END 

Ends the monitor option command section. 
See Also 

"Selecting the Type of Monitor" in the "Configuring the Emulator" chapter. 
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Settings^Emulator Config^Trace Options... (ALT, S, 
E, T) 

Specifies the trace options configuration. 
Trace Options Dialog 

Box Choosing the Settings— ^Emulator Config— >Trace Options... (ALT, S, E, 
T) command opens the following dialog box: 



Trace Option Config 



^T.r.^.??. JQiM.A. py?!.?* J 

Trace Refresh cycles 
Trace Hold cycles 



□ 
□ 

□ 



OK 



Apply 



Help | 



Trace DMA 
cycles 



Enables or disables trace DMA cycles. 



Trace Refresh Enables or disables trace Refresh cycles, 
cycles 



Trace Hold 
cycles 

OK 

Cancel 
Apply 



Enables or disables trace Hold cycles. 

Stores current modification and closes the dialog box. 
Cancels the current modification and closes the dialog box. 
Loads the trace option configuration to the emulator. 



286 



Chapter 8: Menu BarCommands 
Settings-Emulator Config-^Trace Options... (ALT, S, E, T) 

Command File Command 

CON (FIG) TRA ( CE_C YCLE ) DMA ON/ OFF 
Enables or disables trace DMA cycles. 

CON (FIG) TRA (CE_CYCLE) REF (RESH) ON/OFF 
Enables or disables trace Refresh cycles. 

CON (FIG) TRA (CE_CYCLE) HOL (D) ON/OFF 
Enables or disables trace Hold cycles. 

Any of the above command file commands must be preceded and followed by 
the respective start and end commands: 

CON (FIG) STA(RT) 

Starts the configuration option command section. 
CON (FIG) END 

Ends the configuration option command section. 
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Settings^Emulator Config^Pod... (ALT, S, E, P) 

Specifies the emulation pod configuration. 

Because the following configuration is automatically set up by selecting 
processor type in Hardware Configuration, you don't need to set up these 
items when your processor can be specified in Hardware Configuration. If 
your processor is not supported (when you select "others" for the 
configuration item) , you need to set up proper value in this pod 
configuration. 



Pod Config Dialog Box 

Choosing the Settings-^Emulator Config-^Pod... (ALT, S, E, P) command 
opens the following dialog box: 



'od Config 



Internal SFR address area 
Internal RAM address area 
Internal ROM address 



0 07f 



OK 



080. 27f 



Cancel 



OcOOO.Offff 



Apply 



05e 



Help 1 



Internal SFR Specifies internal SFR address, 
area 

Internal RAM areaSpecifies internal RAM address. 
Internal ROM areaSpecifies internal ROM address. 
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Processor mode Specifies processor mode register address, 
register address 



OK 



Stores current modification and closes the dialog box. 



Cancel 



Cancels the current modification and closes the dialog box. 



Apply 



Loads the trace option configuration to the emulator. 



Command File Command 

CON (FIG) ISF (R) address_range, address_range 
Maps specified address range as internal SFR area. 

CON (FIG) IRA (M) address_range 

Maps specified address range as internal RAM area. 

CON (FIG) IRO(M) address_range 

Maps specified address range as internal ROM area. 

CON (FIG) IPM(R) address 

Maps specified address as processor mode register. 

Any of the above command file commands must be preceded and followed by 
the respective start and end commands: 

CON (FIG) STA(RT) 

Starts the configuration option command section. 
CON (FIG) END 

Ends the configuration option command section. 



289 



Chapter 8: Menu BarCommands 
Settings-^Communication... (ALT, S, C) 



Settings^Communication... (ALT, S, C) 

Choosing this command opens the RTC Emulation Connection Dialog Box 
which lets you identify and set up the communication channel between the 
personal computer and the HP 64700. 

RTC Emulation Connection Dialog Box 

Choosing the Settings— ^Communication... (ALT, S, C) command opens the 
following dialog box: 





RTC Emulation Connection 






Emulator: CONNECTED 






User Name: 


RTC Transport: 




HP-ARPA 




User ID: 


1 Connection: 
Transport Selection: 




Isdzodl 1 




H P AR PA 








Novell LanWorkPlace 

RS232C 
HP RS422 
Demo 




| Connect j 
Close j 
Help | 




User Name: 


RTC 








User ID: 


1 







The top part of the dialog box shows the current communication settings. 

Transport Lets you choose the type of connection to be made to the 

Selection HP 64700. Double-clicking causes the current connection 

to be tried with the given transport. Single-clicking selects 
the transport for use with the Setup button. 
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User Name This name tells the HP 64700 and other users who you are. 

When other users attempt to access the HP 64700 while 
you are using it or while it is locked, a message tells them 
you're using it. 

User ID Another method of identifying yourself to the HP 64700 

and other users. This is primarily useful in a mixed UNIX 
and MS-DOS environment; when a UNIX user tries to 
unlock an emulator, the user ID is used to look into the 
/etc/passwd entry on the UNIX host for the user name. 

If your HP 64700 is on the LAN, we recommend that you 
change User Name and User ID so that other users can 
easily tell if an emulator is in use and by whom. Also, if you 
don't change the User Name/ID from the defaults, the 
File— >Exit HW Locked (ALT, F, H) command has no effect 
because all users are identical. 

Setup Opens a transport-specific dialog box which usually allows 

you to change the connection and unlock the emulator. 

In the HP-ARPA or Novell- WP Setup dialog boxes, enter 
the IP address or network name of the HP 64700. 

In the RS232C Setup dialog box, select the baud rate and 
the name of the port (for example, COM1, COM2, etc.) to 
which the HP 64700 is connected. 

In the HP-RS422 Setup dialog box, select the baud rate and 
specify the I/O address you want to use for the HP 64037 
card. The I/O address must be a hexadecimal number from 
100H through 3F8H, ending in 0 or 8, that does not conflict 
with other cards in your PC. 

The Connect button in any of these Setup dialog boxes 
starts the debugger with the specified communication 
settings. 

Close Either closes the Real-Time C Debugger, if the current 

connection failed, or simply closes the dialog box. 
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The Real-Time C Debugger does not allow you to change connection or 
transport information without leaving the debugger and editing the command 
line or the .INI file, but it does allow you to see the current connection and 
transport being used. 

The command line options for connection and transport (-E and -T) take 
precedence over the values in the .INI file. Note that the Program Manager 
item set up during debugger software installation uses these command line 
options. 
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Settings^BNC^BNC Drive Trigger (ALT, S, B, D) 

Specifies that the analyzer trigger signal be driven on the BNC port. 

Selecting the emulator BNC port for output enables the trigger signals to be 
fed to external devices (for example, logic analyzers) during tracing. 

CAUTION Do not drive the BNC beyond the range of 0 to 5 volts. Doing so may cause 

permanent damage to the HP 64700. 



The BNC's drivers can drive 50 ohm loads. 



The following is a logical diagram of the BNC connection. The physical 
implementation and values of resistors are not exact; this diagram is just to 
help you understand the BNC interface: 



arm on rising edge 

clear arm at start of new trace 



BNC 

& 



soon 



soon 

^WV— 



3 on 



output 
enable 



<r 



+5 volts 



— drivE high tram trigger until 
srart af next tmcQ 



When a trace starts, it stops driving the output (so if nothing else is driving 
the line, it will fall low due to the 500 ohm pull-down resistor). 

When the trigger point is found, the BNC starts driving the output high. It 
will stay high until the start of the next trace. 

Command File Command 

MOD (E) BNC OUT (PUT_TRIGGER) 
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See Also 

"To output the trigger signal on the BNC port" in the "Setting Up the BNC 
Port" section of the "Configuring the Emulator" chapter. 
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Settings^BNC^BNC Receive Arm (ALT, S, B, R) 

Allows the analyzer to receive an arm signal from the BNC port. 

This command allows an external trigger signal to be used as an arm (enable) 
condition for the internal analyzer. The internal analyzer will arm (or enable) 
on a positive edge TTL signal. 



CAUTION Do not drive the BNC beyond the range of 0 to 5 volts. Doing so may cause 

permanent damage to the HP 64700. 



You can use the arm condition when setting up custom trace specifications 
with the Trace— >Find Then Trigger... (ALT, T, D) or Trace— ^Sequence... 
(ALT, T, Q) commands. For example, you can trigger on the arm condition 
or enable the storage of states on the arm condition. The "arm" condition 
may be selected in "set2" of the Trace Condition or Count Condition dialog 
boxes. 

The BNC port is internally terminated with about 500 ohms; if using a 50 ohm 
driver, use an external 50 ohm termination (such as the HP 10100C 50 Ohm 
Feedthrough Termination) to reduce bouncing and possible incorrect 
triggering. 

Command File Command 

MOD (E) BNC INP(UT_ARM) 

See Also 

"Settings->BNC->Outputs Analyzer Trigger (ALT, S, B, O) for a logical 
schematic of the BNC interface. 

"To receive an arm condition input on the BNC port" in the "Setting Up the 
BNC Port" section of the "Configuring the Emulator" chapter. 
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Settings^Coverage^Coverage ON (ALT, S, V, O) 

Selects execution coverage display in the Source window. 

When the execution coverage display is selected, accessed lines are 
highlighted in the Source window. 

In the coverage calculation, the system counts not only memory access for 
program code execution but also memory access due to operations such as 
prefetching. 

The coverage calculation must be initialized with the 

Settings— ^Coverage— ^Coverage Reset (ALT, S, V, R) command before the 

Settings->Coverage->Coverage ON (ALT, S, V, 0) command is selected. 

The system does not support coverage calculation for target system memory. 

Command File Command 

COV(ERAGE) ON 

See Also 

To display execution coverage in the "Making Coverage Measurements" 
section of the "Debugging Programs" chapter. 
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Settings^Coverage^Coverage OFF (ALT, S, V, F) 

Deselects execution coverage display in the Source window. 

Command File Command 

COV(ERAGE) OFF 

See Also 

To display execution coverage in the "Making Coverage Measurements" 
section of the "Debugging Programs" chapter. 
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Settings^Coverage^Coverage Reset (ALT, S, V, R) 

Resets the coverage calculation. 

The coverage calculation must be initialized with this command before it is 
started with the Settings->Coverage->Coverage ON (ALT, S, V, 0) 
command. It must also be initialized prior to the coverage calculation 
immediately after the emulator powerup. 

Command File Command 

COV(ERAGE) RES(ET) 

See Also 

To display execution coverage in the "Making Coverage Measurements" 
section of the "Debugging Programs" chapter. 
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Settings^Font... (ALT, S, F) 

Selects the fonts used in the debugger windows. 
Font Dialog Box 

Choosing the Settings— >Font... (ALT, S, F) command opens the following 
dialog box: 



Font: 



Font Stifle: 



Size: 



1 1 einnndfl 


Regular 


Courier 




| Regular 




T Courier New 






Italic 




Fixedsys 






Bold 




MS LineDraw 






Bold Italic 




II Terminal 











14 



Sample' 



fiaBbVyZz 



OK 



Cancel 



Font Lets you select the font to be used in the Real-Time C 

Debugger interface. The "T" shaped icon indicates a 
TrueType font. 

Font Style Lets you select the typeface, for example, regular, bold, 

italic, etc. 

Size Lets you select the size of the characters. 

Sample Shows you what the selected font looks like. 

OK Sets the font, and closes the dialog box. 

Cancel Cancels font setting, and closes the dialog box. 
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See Also 

"To change the debugger window fonts" in the "Working with Debugger 
Windows" section of the "Using the Debugger Interface" chapter. 
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Settings^Tabstops... (ALT, S, T) 

Sets the number of spaces between tabstops. 
Source Tab Dialog Box 

Choosing the Settings-^Tabstops... (ALT, S, T) command opens the following 
dialog box: 



jQ Source Tab 


Tab width in source 
window display: 




c 


Cancel | 





Tab width in Enter the number of spaces between tabstops. This also 
source window affects the tab width for source lines in the Trace window, 
display 

OK Sets the tabstops, and closes the dialog box. 

Cancel Cancels tabstop setting, and closes the dialog box. 

See Also 

"To set tabstops in the Source window" in the "Working with Debugger 
Windows" section of the "Using the Debugger Interface" chapter. 
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Settings^Extended Setting^Trace Cycles^User 
(ALT, S, X, T, U) 

Trace foreground emulation microprocessor operation. 
This is the normal setting. 

Command File Command 

MOD (E) TRA (CECLOCK) USE (R) 
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Settings^Extended Setting^Trace Cycles^Monitor 
(ALT, S, X, T, M) 

Trace background emulation microprocessor operation. 
This is rarely a useful setting when debugging programs. 

Command File Command 

MOD (E) TRA (CECLOCK) BAC (KGROUND) 
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(ALT, S, X, T, B) 

Trace both foreground and background emulation microprocessor operation. 

Command File Command 

MOD (E) TRA (CECLOCK) BOT (H) 
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Settings^Extended Setting^Load Error Abort^On 
(ALT, S, X, L, O) 

An error during an object file or memory load caused an abort. 

Normally, when an error occurs during an object file or memory load, you 
want the load to stop so that you can fix whatever caused the error. 

Command File Command 

MOD (E) DOW (NLOAD) ERR (ABORT) 
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Settings^Extended Setting^Load Error Abort^Off 
(ALT, S, X, L, F) 

An error during an object file or memory load does not cause an abort. 

If you expect certain errors during an object file or memory load, for 
example, if part of file is located at "guarded memory" or "target ROM", you 
can choose this command to continue loading in spite of the errors. 

Command File Command 

MOD (E) DOW (NLOAD) NOE (RRABORT) 
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Settings^Extended Settings Source Path Query^ON 
(ALT, S, X, S, O) 

You are prompted for source file paths. 

When the debugger cannot find source file information for the Source or 
Trace windows, it may prompt you for source file paths depending on the 
MODE SOURCE setting. 

Command File Command 

MOD (E) SOU(RCE) ASK (PATH) 
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Settings^Extended Setting^Source Path Query^OFF (ALT, S, X, S, F) 



Settings^Extended Settings Source Path 
Query^OFF (ALT, S, X, S, F) 

You are not prompted for source file paths. 

You can turn off source path prompting, for example, to avoid annoying 
dialog interactions when tracing library functions for which no source files 
are available. 

Command File Command 

MOD (E ) SOU(RCE) NOA ( SKPATH) 
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Window^Cascade (ALT, W, C) 

Arranges, sizes, and overlaps windows. 

Windows are sized, evenly, to be as large as possible. 



Window^Tile (ALT, W, T) 

Arranges and sizes windows so that none are overlapped. 
Windows are sized evenly. 



Windows Arrange Icons (ALT, W, A) 

Rearranges icons in the Real-Time C Debugger window. 

Icons are distributed evenly along the lower edge of the Real-Time C 
Debugger window. 
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Windows 1-9 (ALT, W, 1-9) 

Opens the window associated with the number. 

The nine most recently opened windows appear in the menu list. If the 
window you wish to open is not on the list, choose the Window— >More 
Windows... (ALT, W, M) command. 

Windows are closed just ordinary MS Windows, that is, by opening the 

control menu and choosing Close or by pressing CTRL+F4. 

The debugger has the following windows: 
BackTrace 

Basic Registers 

Button 

Expression 

I/O 

Memory 

SFR Registers 

Source 

Status 

Symbol 

Trace 

WatchPoint 

For details on the each of these windows, refer to the "Debugger Windows" 
section in the "Concepts" information. 

Command File Command 

DIS(PLAY) window-name 
Opens the specified window. 
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DIS(PLAY) REG ( ISTER) window-number 
Opens the specified SFR registers window. 

ICO (NIC) window-name 
Closes the specified window. 

ICO (NIC) REG (ISTER) window-number 
Closes the specified SFR registers window. 



Select Window 



Inteirupt Control Registers D 



Watchdog Timer Registers 

Timer Registers 

Button 

UART 0 Registers 
UART 1 Registers 
A-D conversion Registers 
I/O 



Cancel 



See Also 

To open debugger windows in the "Working with Debugger Windows" section 
of the "Using the Debugger Interface" chapter. 
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Window^More Windows... (ALT, W, M) 

Presents a list box from which you can select the window to be opened. 
Select Window Dialog Box 

Choosing the Window— >More Windows... (ALT, W, M) command opens the 
following dialog box: 

OK Opens the window selected in the list box. 

Cancel Closes the dialog box. 

Command File Command 

DIS(PLAY) window-name 
Opens the specified window. 

ICO (NIC) window-name 
Closes the specified window. 

See Also 

"To open debugger windows" in the "Working with Debugger Windows" 
section of the "Using the Debugger Interface" chapter. 
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Help^About Debugger/Emulator... (ALT, H, D) 

Provides information on the Real-Time C Debugger. 

Choosing the Help— > About Debugger/Emulator... (ALT, H, D) command 
opens a dialog box containing the version information on the current 
Real-Time C Debugger and emulator. 



£2 Source Directory 


Module: 


□ K | 


Directory: 


Cancel 




Help 
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Source Directory Dialog Box 

When the source file associated with a symbol cannot be found in the current 
directory, the following dialog box is opened: 



Module Shows the symbol whose source file could not be found. 

Directory Lets you enter the directory in which the source file 

associated with the symbol may be found. 

OK Adds the directory entered in the Directory text box to the 

source file search path. 



Cancel 



Closes the dialog box. 
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WAIT Command Dialog Box 

This dialog box appears when the WAIT command is included in a command 
file, break macro, or button. 

Choosing the STOP button cancels the WAIT command. 
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Window Control Menu Commands 



This chapter describes the commands that can be chosen from the control 
menus in debugger windows. 

• Common Control Menu Commands 

• Button Window Commands 

• Expression Window Commands 

• I/O Window Commands 

• Memory Window Commands 

• Registers Windows' Commands 

• Source Window Commands 

• Symbol Window Commands 

• Trace Window Commands 

• WatchPoint Window Commands 
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Common Control Menu Commands 



Common Control Menu Commands 

This section describes commands that appear in the control menus of most of 
the debugger windows: 

• Copy-^ Window (ALT, -, P, W) 

• Copy-^Destination... (ALT, -, P, D) 



Copy^ Window (ALT, -, P, W) 

Copies the current window contents to the destination file specified with the 
File— »Copy Destination... (ALT, F, P) command. 

Command File Command 



COP (Y) 


BAC (KTRACE) 


COP (Y) 


BAS (IC) 


COP (Y) 


BUT (TON) 


COP (Y) 


EXP (RESSION) 


COP (Y) 


10 


COP (Y) 


MEM (ORY) 


COP (Y) 


REG ( ISTER) window-number 


COP (Y) 


SOU (RCE) 


COP (Y) 


WAT (CHPOINT) 


See Also 



"To copy window contents to the list file" in the "Working with Debugger 
Windows" section of the "Using the Debugger Interface" chapter. 
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Copy^Destination... (ALT, -, P, D) 

Names the listing file to which debugger information may be copied. 

This command opens a file selection dialog box from which you can select the 
listing file. Listing files have the extension ".LST". 

Command File Command 

COP (Y) TO filename 

See Also 

"To change the list file destination" in the "Working with Debugger Windows" 
section of the "Using the Debugger Interface" chapter. 



320 



Chapter 9: Window Control M enu Commands 
Button Window Commands 



Button Window Commands 

This section describes the following command: 
• Edit... (ALT, -, E) 



Edit... (ALT, -, E) 

Lets you define and label buttons in the Button window. 

You can set up buttons to execute commonly used commands or command 
files. 



Button Edit Dialog Box 

Choosing the Edit... (ALT, -, E) command opens the following dialog box: 



Button Edit 



rEdir 



Command: 
Name: 



FILE COMMAND cmdfile2.cmd 



Cmd2 



Button Definitions' 



[Cmd1] FILE COMMAND cmdfile1.cmd 



Delete 



Delete All ~| 



Close 



Help 



Command Specifies the command to be associated with the button. 

You can enter command file commands. 
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Name 



Specifies the button label to be associated with the 
command. 



Add 



Adds the button to the button window. 



Button 
Definitions 



Lists the currently defined buttons. You can select button 
definitions for deletion by clicking on them. 



Delete 



Deletes the button definition selected in the Button 
Definitions list box. 



Delete All 



Deletes all buttons from the Button window. 



Close 



Closes the dialog box. 



Command File Command 

BUTTON label "command" 

See Also 

"To create buttons that execute command files" in the "Using Command 
Files" section of the "Using the Debugger Interface" chapter. 
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Expression Window Commands 

This section describes the following commands: 

• Clear (ALT, -, R) 

• Evaluate... (ALT, -, E) 



Clear (ALT, -, R) 

Erases the contents of the Expression window, window. 

Command File Command 

EVA (LUATE) CLE (AR) 
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Evaluate... (ALT, -, E) 

Evaluates expressions and displays the results in the Expression window. 
Evaluate Expression Dialog Box 

Choosing the Evaluate... (ALT, -, E) command opens the following dialog box: 



0 Evaluate Expression 


Expression: Evaluate j 


fcmessage_ioj 


Close j 




Help | 



Expression Lets you enter the expression to be evaluated. 

Evaluate Makes the evaluation and places the results in the 

Expression window. 

Close Closes the dialog box. 

Command File Command 

EVA ( LUATE ) address 

EVA (LUATE) "strings" 
See Also 

"Symbols" in the "Expressions in Commands" chapter. 
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I/O Window Commands 

This section describes the following command: 
• Define... (ALT, -, D) 



Define... (ALT, -, D) 

Adds or deletes memory mapped I/O locations from the I/O window. 
I/O Setting Dialog Box 

Choosing the Edit— ^Definition... command opens the following dialog box: 



I/O Setting 



Set 

Address 

SJze: 



2000 



<§> byte O 16 Bits 
® Mem | Set | 



I/O set 



address: 0002000. size: byte 



Delete \ 



Close 



Help I 



Address 



Specifies the address of the I/O location to be defined. 
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Size 



Specifies the data format of the I/O location to be defined. 
You can select the Byte or 16 Bits option. 



Space 



Specifies whether the I/O location is in memory or I/O 
space. 



Set 



Adds the specified I/O location. 



I/O set 



Displays the information on the I/O locations that have 
been set. 



Delete 



Deletes the I/O locations selected in the I/O set list box. 



Close 



Closes the dialog box. 



Command File Command 

10 BYTE/WORD IOSPACE/MEMORY address TO data 

Replaces the contents of the specified I/O address with the specified value in 

the specified size. 

10 SET BYTE/WORD IOSPACE/MEMORY address 
Registers the I/O address to be displayed in the specified size. 

10 DEL (ETE) BYTE/WORD IOSPACE/MEMORY address 
Deletes the I/O specified with its address and size. 

See Also 

"Displaying and Editing I/O Locations" in the "Debugging Programs" chapter. 
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Memory Window Commands 

This section describes the following commands: 

• Display— ^Linear (ALT, -, D, L) 

• Display-^Block (ALT, -, D, B) 

• Display->Byte (ALT, -, D, Y) 

• Display->16 Bits (ALT, -, D, 1) 

• Display->32 Bits (ALT, -, D, 3) 

• Search... (ALT, -, R) 

• Utilities^Copy... (ALT, -, U, C) 

• UtOities-»Fffl... (ALT, -, U, F) 

• Utilities-^Image... (ALT, -, U, I) 

• Utilities^Load... (ALT, -, U, L) 

• Utilities^Store... (ALT, -, U, S) 



Display^Linear (ALT, -, D, L) 

Displays memory contents in single column format. 

Command File Command 

MEM(ORY) ABS(OLUTE) 
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Display^Block (ALT, -, D, B) 

Displays memory contents in multi-column format. 

Command File Command 

MEM(ORY) BLO(CK) 



Display^Byte (ALT, -, D, Y) 

Displays memory contents as bytes. 

Command File Command 

MEM(ORY) BYTE 



Display^l6 Bit (ALT, -, D, 1) 

Displays memory contents as 16-bit values. 

Command File Command 

MEM(ORY) WORD 
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Display^32 Bit (ALT, -, D, 3) 

Displays memory contents as 32-bit values. 

Command File Command 

MEM(ORY) LONG 



Search... (ALT, -, R) 

Searches for a value or string in a range of memory. 

When the value or string is found, the location is displayed in the Memory 
window. Choose the Window— ^Memory command to open the window. 

The value or string can be selected from another window (in other words, 
copied to the clipboard) before choosing the command; the contents of the 
clipboard will automatically appear in the dialog box that is opened. 

Search Memory Dialog Box 

Choosing the Search... (ALT, -, R) command opens the following dialog box: 



Value: 
String: 
Start: 
End: 

Size: 



Search Memory 



This 



2000 



Offff 



byte O IGBits 



Search 



Close 



Help | 



Value 



Lets you enter a value. 
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String 



Lets you enter a string. 



Start 



Lets you enter the starting address of the memory range to 
search. 



End 



Lets you enter the end address of the memory range to 
search. 



Size 



Selects the data size using the Byte, 16 Bits, or 32 Bits 
option buttons. 



Execute 



Searches for the specified value or string. 



Close 



Closes the dialog box. 



Command File Command 

SEA(RCH) MEM(ORY) BYTE/WORD/LONG addr_range value 
SEA(RCH) MEM(ORY) STR(ING) "string" 

See Also 

"To search memory for a value or string" in the "Displaying and Editing 
Memory" section of the "Debugging Programs" chapter. 
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Utilities^Copy... (ALT, -, U, C) 

Copies the contents of one memory area to another. 
Memory Copy Dialog Box 

Choosing the Utilities— >Copy... (ALT, -, U, C) command opens the following 
dialog box: 



Memory Copy 



Stait: 
End: 

Destination 



Copy 



0000087 



G4000 



Close 



Help 



Size: ® byte O 16 Bits 



Start 
End 

Destination 
Size 

Execute 
Close 



Lets you enter the starting address of the source memory 
area. 

Lets you enter the end address of the source memory area. 

Specifies the starting address of the destination memory 
area. 

Selects the data size using the Byte, 16 Bits, or 32 Bits 
option buttons. 

Copies the memory contents. 

Closes the dialog box. 



Command File Command 

MEM(ORY) COP (Y) size address_range address 
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See Also 

"To copy memory to a different location" in the "Displaying and Editing 
Memory" section of the "Debugging Programs" chapter. 



Utfflties->Fill... (ALT, -, U, F) 

Fills a range of memory with a specified value. 



Memory Fill Dialog Box 

Choosing the Utilities— >Fill... (ALT, -, U, F) command opens the following 
dialog box: 



Memory Fill 



Value: 

Stait: 

End: 



0000000 



0000087 



Size: <g> byte O 16 Bits 



Fill 



Close 



Jelp_J 



Value 
Start 



Lets you enter the filling value. 

Lets you enter the starting address of the memory area to 
be filled. 



End 



Lets you enter the end address of the memory area to be 
filled. 



Size 



Selects the size of the filling value. If the value specified is 
larger than can fit in the size selected, the upper bits of the 
value are ignored. You can select the size using the Byte, 
16 Bits, or 32 Bits option buttons. 



Execute 



Executes the command. 
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Close Closes the dialog box. 

Command File Command 

MEM(ORY) FIL(L) size address_range data 
See Also 

"To modify a range of memory with a value" in the "Displaying and Editing 
Memory" section of the "Debugging Programs" chapter. 



Utilities^Image... (ALT, -, U, I) 

Copies the contents of a target system memory range into the corresponding 
emulation memory range. 

You can copy programs that are in target system ROM to emulation memory. 
Once the program code is in emulation memory, you can use features like 
breakpoints, run until, etc. 

The address range must be mapped as emulation memory before choosing 
this command. 
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Memory Image Dialog Box 

Choosing the Utilities— >Image... (ALT, -, U, I) command opens the following 
dialog box: 



Memory Image 



Stait: 

End: 

Size: 



Offf 



OK 



byte O 16 Bits 



Close 



Help j 



Start Lets you enter the starting address of the memory area. 

End Lets you enter end address of the memory area. 

Size Selects the data size using the Byte, 16 Bits, or 32 Bits 

option buttons. 

Execute Copies the target system memory into emulation memory. 

Close Closes the dialog box. 

Command File Command 

MEM(ORY) IMA(GE) size address_range 
See Also 

"To copy target system memory into emulation memory" in the "Displaying 
and Editing Memory" section of the "Debugging Programs" chapter. 
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Utilities^Load... (ALT, -, U, L) 

Loads memory contents from a previously stored file. 
Load Binary File Dialog Box 

Choosing the Utilities— »Load... (ALT, -, U, L) command opens the following 
dialog box: 



Load Binary File 



File Name: 
Bytes 
Record Format: 



C:\HP\RTC\M7700\data dat 



| Load j 



Motorola S-Record 



Cancel 



Browse. 



Help | 



File Name 



Lets you enter the name of the file to load memory from. 



Bytes Loaded After you choose the Import button, this box shows the 
number of bytes that are loaded. 

Record Format Lets you specify the format of the file from which you're 
loading memory. You can load Motorola S-Record or Intel 
Hexadecimal format files. 

Load Starts the memory load. 

Cancel Closes the dialog box. 

Browse... Opens a file selection dialog box from which you can select 

the file name. 



Command File Command 

MEM(ORY) LOA(D) MOT (OSREC) filename 
MEM(ORY) LOA(D) INT (ELHEX) filename 
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See Also 

"To copy target system memory into emulation memory" in the "Displaying 
and Editing Memory" section of the "Debugging Programs" chapter. 

Utilities-^Store... (ALT, -, U, S) 



Utilities^Store... (ALT, -, U, S) 

Stores memory contents to a binary file. 
Store Binary File Dialog Box 

Choosing the Utilities— »Store... (ALT, -, U, S) command opens the following 
dialog box: 



Uj Store Binary File 




||C:\HP\RTC\M7700\data dat|| 


Store | 






Bytes Stored: 0 


Cancel j 






Record Format: Motorola S Record | [±| 


Browse... | 




Start: 0000000 End: 1 0000050 


Help 





File Name Lets you enter the name of the file to which memory 

contents are stored. 

Bytes Stored After you choose the Export button, this box shows the 
number of bytes that are stored. 

Record Format Lets you specify the format of the file to which you're 

storing memory. You can select Motorola S-Record or Intel 
Hexadecimal formats. 
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Start Lets you enter the starting address of the memory range to 

be stored. 

End Lets you enter the ending address of the memory range to 

be stored. 

Store Starts the memory store. 

Cancel Closes the dialog box. 

Browse... Opens a file selection dialog box from which you can select 

a file name. 

Command File Command 

MEM(ORY) STO(RE) MOT (OSREC) addr-range filename 
MEM(ORY) STO(RE) INT (ELHEX) addr-range filename 

See Also 

"To copy target system memory into emulation memory" in the "Displaying 
and Editing Memory" section of the "Debugging Programs" chapter. 

Utilities-»Load... (ALT, -, U, L) 
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Register Windows' Commands 

This section describes the following commands: 

• Continuous Update (ALT, -, U) 

• Copy->Registers (ALT, -, P, R) 



Continuous Update (ALT, -, U) 

Specifies whether the Register window contents should be continuously 
updated while running programs. 

A check mark (V) next to the command shows that continuous update is 
active. 



Copy^Registers (ALT, -, P, R) 

Copies the current Register window contents to the destination file specified 
with the File— >Copy Destination... (ALT, F, P) command. 

Command File Command 

COP(Y) REG ( ISTER) 

Copy Basic Register windows contents to the destination file. 

COP(Y) REG (ISTER) window-number 

Copy SFR Register windows contents to the destination file. 



338 



Chapter 9: Window Control M enu Commands 
Register Windows' Commands 



Register Bit Fields Dialog Box 

When a register has bit-fields, a dialog will pop-up and the register value may 
be edited by changing the whole value or by editing individual bit-fields. 



j Register Bit F 


ields 




PROCESSOR STATUS REGISTER - ps 


OK | 
Cancel j 

i e| p 1 


Edited value: 24 




Oiiginal Value: 24 




Desciiption 


Value 


Bit(s) 


Negative(N) 


□ 


7 


Oveiflow(O) 


□ 


6 


Data Length(m) 




5 


Index Register Length(x) 


□ 


4 


Decimal(D) 


□ 


3 


Interrupt(l) 


El 


2 


ZerofZ) 


□ 


1 


Carry(C) 


□ 


0 



When editing in the dialog box, a carriage-return is the same as choosing the 
OK button. To end an edit of a field within the dialog box without quitting, 
use the Tab key 

Edited Value 



Original Value 



OK 



Shows the register value that corresponds to the selections 
made below. You can also change the register's value by 
modifying the value in this text box. 

Shows the value of the register when the dialog box was 
opened. If the register could not be read, 'XXXXXXXX' is 
displayed. 

Modifies the register as specified, and closes the dialog box. 
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Cancel Closes the dialog box without modifying the register. 
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Source Window Commands 

This section describes the following commands: 

• Display-^Mixed Mode (ALT, -, D, M) 

• Display-Source Only (ALT, -, D, S) 

• Display-Select Source... (ALT, -, D, L) 

• Display-^Options^mOxO (ALT, -, D, O) 

• Display->Options->m0xl (ALT, -, D, O) 

• Display->Options->mlxO (ALT, -, D, O) 

• Display->Options->mlxl (ALT, -, D, O) 

• Search-String... (ALT, -, R, S) 

• Search-Function... (ALT, -, R, F) 

• Search-^Address... (ALT, -, R, A) 



Display^Mixed Mode (ALT, -, D, M) 

Chooses the source/mnemonic mixed display mode. 

Command File Command 

MOD (E) MNE(MONIC) ON 

See Also 

"To display source code mixed with assembly instructions" in the "Loading 
and Displaying Programs" section of the "Debugging Programs" chapter. 
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Display^Source Only (ALT, -, D, S) 

Chooses the source only display mode. 

Command File Command 

MOD (E) MNE(MONIC) OFF 

See Also 

"To display source code only" in the "Loading and Displaying Programs' 
section of the "Debugging Programs" chapter. 
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Display^Select Source... (ALT, -, D, L) 

Displays the contents of the specified C source file in the Source window. 

This command is disabled before the object file is loaded or when no source 
is available for the loaded object file. 

Select Source Dialog Box 

Choosing the Display-^Select Source... (ALT, -, D, L) command opens the 
following dialog box: 



E5 Select Source 




Source Files: 








sample. c 




**** I 




Close | 


Diiectoiy... j 




Help 











Source Files Lists C source files associated with the loaded object file. 

You can select the source file to be displayed from this list. 

Select Switches the Source window contents to the selected 

source file. 

Close Closes the dialog box. 



Directory Opens the Search Directories Dialog Box from which you 

can add directories to the search path. 

Command File Command 

FIL(E) SOU(RCE) module_name 
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See Also 

"To display source files by their names" in the "Loading and Displaying 
Programs" section of the "Debugging Programs" chapter. 



Display^Options^mOxO 

Specify mOxO as ma: flag. When you display source code mixed with 
assembly instructions, you need to tell the emulator what value of mx flag 
should be used to disassemble the memory contents. This is needed because 
the length of operand is variable according to mx flag. 

Every time the inverse assembler encounters an instruction which changes 
mx flag, the value set by the instruction is used to disassemble memory 
contents. 

Command File Command 

MOD (E) SOU(RCE) DIS (PLAY) mOxO 



Display^Options^mOxl 

Specify mOxl as ma; flag. When you display source code mixed with 
assembly instructions, you need to tell the emulator what value of mx flag 
should be used to disassemble the memory contents. This is needed because 
the length of operand is variable according to mx flag. 

Every time the inverse assembler encounters an instruction which changes 
mx flag, the value set by the instruction is used to disassemble memory 
contents. 

Command File Command 

MOD (E) SOU(RCE) DIS (PLAY) mOxl 
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Display^Options^mlxO 

Specify mlxO as mxflag. When you display source code mixed with 
assembly instructions, you need to tell the emulator what value of mx flag 
should be used to disassemble the memory contents. This is needed because 
the length of operand is variable according to mx flag. 

Every time the inverse assembler encounters an instruction which changes 
mx flag, the value set by the instruction is used to disassemble memory 
contents. 

Command File Command 

MOD (E ) SOU(RCE) DIS (PLAY) mlxO 



Display^Options^mlxl 

Specify mlxl as mxflag. When you display source code mixed with 
assembly instructions, you need to tell the emulator what value of mx flag 
should be used to disassemble the memory contents. This is needed because 
the length of operand is variable according to mx flag. 

Every time the inverse assembler encounters an instruction which changes 
mx flag, the value set by the instruction is used to disassemble memory 
contents. 

Command File Command 

MOD (E ) SOU(RCE) DIS (PLAY) mlxl 
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Search^String... (ALT, -, R, S) 

Searches for, and displays, a string in the Source window. 

The search starts from the current cursor position in the Source window, 
may be either forward or backward, and may be case sensitive. 

The string can be selected from another window (in other words, copied to 
the clipboard) before choosing the command; it will automatically appear in 
the dialog box that is opened. 

Search String Dialog Box 

Choosing the Search— ^String... (ALT, -, R, S) command opens the following 
dialog box: 



^ Search String 


Find What: sample) 


Find Next ij 


El Match Case 


Direction 

O Up ® Down 


Cancel | 




Help 1 







Find What 
Match Case 
Up 

Down 

Find Next 
Close 



Lets you enter the string. 

Selects or deselects case matching. 

Specifies that the search be from the current cursor 
position backward. 

Specifies that the search be from the current cursor 
position forward. 

Searches for the string. 

Closes the dialog box. 
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Command File Command 

SEA(RCH) STR(ING) FOR/BACK ON/ OFF strings 
Searches the specified string in the specified direction with the case 
matching option ON or OFF. 

See Also 

"To search for strings in the source files" in the "Loading and Displaying 
Programs" section of the "Debugging Programs" chapter. 



Search^Function... (ALT, -, R, F) 

Searches for, and displays, a function in the Source window. 

The object file and symbols must be loaded before you can choose this 
command. 



Note This command displays the source file based on the function information in 

the object file. Depending on the structure of the function, the command 
may fail in displaying the declaration of the function. 
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Search Function Dialog Box 

Choosing the Search— ^Function... (ALT, -, R, F) command opens the 
following dialog box: 



Search Function 



Function: 



Find 



change status 
conveit 
conveit_case 
irnl dd>a 

next 



Close | 



Help | 



Function Lets you select the function to search for. 

Find Searches the specified function. 

Close Closes the dialog box. 

Command File Command 

SEA(RCH) FUNC(TION) func_name 

See Also 

"To search for function names in the source files" in the "Loading and 
Displaying Programs" section of the "Debugging Programs" chapter. 



348 



Chapter 9: Window Control M enu Commands 
Source Window Commands 



Search^Address... (ALT, -, R, A) 

Searches for, and displays, an address in the Source window. 

Address expressions such as function names or symbols can be selected from 
another window (in other words, copied to the clipboard) before choosing 
the command; the contents of the clipboard will automatically appear in the 
dialog box that is opened. 

Search Address Dialog Box 

Choosing the Search-^Address... (ALT, -, R, A) command opens the following 
dialog box: 



Q Search Address 


Address: 


Find | 


GaG 


Close | 




Help | 



Address Lets you enter the address to search for. 

Find Searches for the specified address. 

Close Closes the dialog box. 

Command File Command 

SEA(RCH) ADD (RESS ) address 

See Also 

"To search for addresses in the source files" in the "Loading and Displaying 
Programs" section of the "Debugging Programs" chapter. 
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Search Directories Dialog Box 

Choosing the Directories... button in the Select Source dialog box opens the 
following dialog box: 



Search Directories 



Directory 



Add 



Source Search Directories 



C:\HP\RTC\M77uO\DEMO\SAMPL 



Close 



Help 



Directory Lets you enter the directory to be added to the source file 

search path. 

Search Source Lists the directories in the source file search path. 
Directories 

Add Adds the directory entered in the Directory text box to the 

source file search path. 

Close Closes the dialog box. 

See Also 

"To specify source file directories" in the "Loading and Displaying Programs" 
section of the "Debugging Programs" chapter. 
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Symbol Window Commands 

This section describes the following commands: 

• Display-^Modules (ALT, -, D, M) 

• Display-Functions (ALT, -, D, F) 

• Display-Externals (ALT, -, D, E) 

• Display-^Locals... (ALT, -, D, L) 

• Display->Asm Globals (ALT, -, D, G) 

• Display->Asm Locals... (ALT, -, D, A) 

• Display-^User defined (ALT, -, D, U) 

• Copy-^ Window (ALT, -, P, W) 

• Copy^All (ALT, -, P, A) 

• FindString-^String... (ALT, -, D, M) 

• User defined->Add... (ALT, -, U, A) 

• User defined-^Delete (ALT, -, U, D) 

• User defined-^Delete All (ALT, -, U, L) 



Display^Modules (ALT, -, D, M) 

Displays the symbolic module information from the loaded object file. 

Command File Command 

SYM(BOL) LIS(T) MOD (ULE ) 
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See Also 

"To display program module information" in the "Displaying Symbol 
Information" section of the "Debugging Programs" chapter. 



Display^Functions (ALT, -, D, F) 

Displays the symbolic function information from the loaded object file. 

The Symbol window displays the name, type and address range for C 
functions. 

Command File Command 

SYM(BOL) LIS(T) FUN(CTION) 

See Also 

"To display function information" in the "Displaying Symbol Information" 
section of the "Debugging Programs" chapter. 



Display^Externals (ALT, -, D, E) 

Displays the global variable information from the loaded object file. 

The Symbol window displays the name, type and address for global variables. 

Command File Command 

SYM(BOL) LIS(T) EXT (ERNAL) 

See Also 

"To display external symbol information" in the "Displaying Symbol 
Information" section of the "Debugging Programs" chapter. 
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Display^Locals... (ALT, -, D, L) 

Displays the local variable information on the specified function. 

The function name can be selected from another window (in other words, 
copied to the clipboard) before choosing the command; the clipboard 
contents automatically appear in the dialog box that is opened. 

The Symbol window displays the name, type and offset from the frame 
pointer for the local variables for the specified function. 

Local Symbol Dialog Box 

Choosing the Display— ^Locals... (ALT, -, D, L) command opens the following 
dialog box: 





I Local Symbol 


Function: 


□ K | 


I 


convert caseBj^BBBBrmrmTTOwiiiiffiB] 


Cancel 




Help j 



Function Selects the function for which the local variable 

information is displayed. 

OK Executes the command and closes the dialog box. 

Cancel Cancels the command and closes the dialog box. 

Command File Command 

SYM(BOL) LIS(T) INT (ERNAL) function 
See Also 

"To display local symbol information" in the "Displaying Symbol Information' 
section of the "Debugging Programs" chapter. 



353 



Chapter 9: Window Control M enu Commands 
Symbol Window Commands 

Displays Asm Globals (ALT, -, D, G) 

Displays the global Assembler symbol information from the loaded object file. 

The Symbol window displays the name and address for the global assembler 
symbols. 

Command File Command 

SYM(BOL) LIS(T) GLO(BALS) 

See Also 

To display global assembler symbol information in the "Displaying Symbol 
Information" section of the "Debugging Programs" chapter. 
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Displays Asm Locals... (ALT, -, D, A) 

Displays the local symbol information from the specified module. 

The module name can be selected from another window (in other words, 
copied to the clipboard) before choosing the command; the clipboard 
contents automatically appear in the dialog box that is opened. 

The Symbol window displays the name and address for the local symbols for 
the specified module. 



Note When you use IAR compiler, this function is not avairable. UBROF format file 

compiled by IAR compiler does not include assembler local symbol 
information. As the result, you can not see assembler local symbols using 
IEEE-695 file converted from UBROF file. If you need to debug assembler 
local symbols with IAR tools, you need to specify assembler local symbols by 
using PUBLIC directive. In this case, you can see these symbols in global 
symbols. 



Assembler Symbol Dialog Box 

Choosing the Display— ¥ Asm Locals... (ALT, -, D, A) command opens the 
following dialog box: 



|3 Assembler Symbol 


Module: 


° K I 


sample 


Cancel j 




Help | 



Module Selects the module for which the local symbols are 

displayed. 

OK Executes the command and closes the dialog box. 

Cancel Cancels the command and closes the dialog box. 
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Command File Command 

SYM(BOL) LIS(T) LOC (AL) module 

See Also 

"To display local assembler symbol information" in the "Displaying Symbol 
Information" section of the "Debugging Programs" chapter. 
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Display^User defined (ALT, -, D, U) 

Displays the user-defined symbol information. 

The Symbol window displays the name and address for the user-defined 
symbols. 

The User defined-^Add... (ALT, -, D, U) command adds the user-defined 
symbols. 

Command File Command 

SYM(BOL) LIS(T) USE (R) 

See Also 

"To display user-defined symbol information" in the "Displaying Symbol 
Information" section of the "Debugging Programs" chapter. 



Copy^ Window (ALT, -, P, W) 

Copies the information currently displayed in the Symbol window to the 
specified listing file. 

The listing file is specified with the File— >Copy Destination... (ALT, F, P) 
command. 

Command File Command 

SYM(BOL) COP(Y) DIS (PLAY) 

See Also 

"To copy window contents to the list file" in the "Working with Debugger 
Windows" section of the "Using the Debugger Interface" chapter. 
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Copy^All (ALT, -, P, A) 

Copies all the symbol information to the specified listing file. 

The listing file is specified with the File— >Copy Destination... (ALT, F, P) 
command. 

Command File Command 

SYM(BOL) COP(Y) ALL 



FindString^String... (ALT, -, F, S) 

Displays the symbols that contain the specified string. 
This command performs a case-sensitive search. 

Symbol Matches Dialog Box 

Choosing the FindString->String... (ALT, -, F, S) command opens the 
following dialog box: 



5 Find String 


String: 


OK I 


init 






Help 



String Specifies the string. 

OK Executes the command and closes the dialog box. 
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Cancel Cancels the command and closes the dialog box. 

Command File Command 

SYM(BOL) MAT (CH) string 

See Also 

"To display the symbols containing the specified string" in the "Displaying 
Symbol Information" section of the "Debugging Programs" chapter. 



User defined^Add... (ALT, -, U, A) 

Adds the specified user-defined symbol. 

User-defined symbols may be used in debugger commands just like other 
program symbols. 

The symbol name must satisfy the following requirements: 

• The name must begin with an alphabetical, _ (underscore), or ? 
character. 

• The following characters must be any of alphanumerical, _ (underscore) , 
or ? characters. 

• The maximum number of characters is 256. 
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User defined Symbol Dialog Box 



Choosing the User defined->Add... (ALT, -, U, A) command opens the 
following dialog box: 



User Defined Symbol Add 


Symbol Name: 




OK | 


jmp_stait 


Cancel | 


Address: 




Help J 


6a6j 









Symbol Name Specifies the symbol to be added. 

Address Specifies the address of the symbol. 

OK Executes the command and closes the dialog box. 

Cancel Cancels the command and closes the dialog box. 

Command File Command 

SYM(BOL) ADD symbol_nam address 

See Also 

"To create a user-defined symbol" in the "Displaying Symbol Information" 
section of the "Debugging Programs" chapter. 
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User defined^Delete (ALT, -, U, D) 

Deletes the specified user-defined symbol. 

This command deletes the user-defined symbol selected in the Symbol 
window. 

Command File Command 

SYM(BOL) DEL (ETE) symbol_nam 

See Also 

"To delete a user-defined symbol" in the "Displaying Symbol Information" 
section of the "Debugging Programs" chapter. 



User defined^Delete All (ALT, -, U, L) 

Deletes all the user-defined symbols. 

Command File Command 

SYM(BOL) DEL (ETE) ALL 
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Trace Window Commands 

This section describes the following commands: 

• Display->Bus Cycle ON (ALT, -, D, B) 

• Display-Source Only (ALT, -, D, S) 

• Display->Count->Absolute (ALT, -, D, C, A) 

• Display->Count->Relative (ALT, -, D, C, R) 

• Copy-AVindow (ALT, -, P, W) 

• Copy^All (ALT, -, P, A) 

• Search-^Trigger (ALT, -, R, T) 

• Search-State... (ALT, -, R, S) 

• Trace Spec Copy-Specification (ALT, -, T, S) 

• Trace Spec Copy->Destination... (ALT, -, T, D) 



Display^Bus Cycle ON (ALT, -, D, B) 

Selects the bus cycle mixed display mode. 

Command File Command 

TRA(CE) DIS(PLAY) BUS 

See Also 

"To display bus cycles" in the "Tracing Program Execution" section of the 
"Debugging Programs" chapter. 
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Display^Source Only (ALT, -, D, S) 

Selects the source only display mode. 

Command File Command 

TRA(CE) DIS(PLAY) SOU(RCE) 

See Also 

"To display bus cycles" in the "Tracing Program Execution" section of the 
"Debugging Programs" chapter. 



Display^Count ^Absolute (ALT, -, D, C, A) 

Selects the absolute mode (the total time elapsed since the trigger) for count 
information. 

Command File Command 

TRA(CE) DIS(PLAY) ABS (OLUTE) 

See Also 

"To display accumulated or relative counts" in the "Tracing Program 
Execution" section of the "Debugging Programs" chapter. 
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Display^Count^Relative (ALT, -, D, C, R) 

Selects the relative mode (the time interval between the current and 
previous cycle) for count information. 

Command File Command 

TRA(CE) DIS(PLAY) REL (ATIVE) 

See Also 

"To display accumulated or relative counts" in the "Tracing Program 
Execution" section of the "Debugging Programs" chapter. 



Copy^ Window (ALT, -, P, W) 

Copies the information currently in the Trace window to the specified listing 
file. 

The listing file is specified with the File— >Copy Destination... (ALT, F, P) 
command. 

Command File Command 

TRA(CE) COP (Y) DIS(PLAY) 

See Also 

"To copy window contents to the list file" in the "Working with Debugger 
Windows" section of the "Using the Debugger Interface" chapter. 
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Copy^All (ALT, -, P, A) 

Copies all the trace information to the specified listing file. 

The listing file is specified with the File— >Copy Destination... (ALT, F, P) 
command. 

Command File Command 

TRA(CE) COP (Y) ALL 



Search^Trigger (ALT, -, R, T) 

Positions the trigger state at the top of the Trace window. 

Command File Command 

TRA(CE) FIN (D) TRI (GGER) 
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Search^State... (ALT, -, R, S) 

Positions the specified state at the top of the Trace window. 
Search Trace State Dialog Box 

Choosing the Search— >State... (ALT, -, R, S) command opens the following 
dialog box: 



Q Search Trace State 


State: 


Find | 




Close | 




Help 



State Lets you enter the trace state number to search for. 

Find Searches for the specified trace state. 

Close Closes the dialog box. 

Command File Command 

TRA(CE) FIN (D) STA(TE) state_num 



Trace Spec Copy^Specification (ALT, -, T, S) 

Copies the current trace specification to the listing file. 

Command File Command 

TRA(CE) COP (Y) SPE(C) 
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Trace Spec Copy^Destination... (ALT, -, T, D) 

Names the listing file to which debugger information may be copied. 

This command opens a file selection dialog box from which you can select the 
listing file. Listing files have the extension ".LST". 

Command File Command 

COP (Y) TO filename 
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WatchPoint Window Commands 

This section describes the following command: 
• Edit... 



Edit... (ALT, -, E) 

Registers or deletes watchpoints. 

Variables can be selected from the another window (in other words, copied to 
the clipboard) before choosing the Edit... (ALT, -, E) command from the 
WatchPoint window's control menu, and they will automatically appear in the 
dialog box that is opened. 

Dynamic variables can be registered and displayed in the WatchPoint window 
when the current program counter is in the function in which the variable is 
declared. If the current program counter is not in the function, the variable 
name is invalid and results in an error. 
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WatchPoint Dialog Box 

Choosing the Edit... (ALT, -, E) command from the WatchPoint window's 
control menu opens the following dialog box: 




Variable Lets you enter the name of the variable to be registered as 

a watchpoint. The contents of the clipboard, usually a 
variable selected from the another window, automatically 
appears in this text box. 

Watch Points Lists the current watchpoints and allows you to select the 

Set watchpoint to be deleted. 

Set Copies the specified variable to the WatchPoint window. 

Delete Deletes the variable selected in the Watch Points Set box. 

Delete All Deletes all the watchpoints. 

Close Closes the dialog box. 
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Command File Command 

WP SET address 

Registers the specified address as a watchpoint. 

WP DEL(ETE) address 
Deletes the specified watchpoint. 

WP DEL (ETE ) ALL 

Deletes all the current watchpoints. 

See Also 

"To monitor a variable in the WatchPoint window" in the "Displaying and 
Editing Variables" section of the "Debugging Programs" chapter. 

"Symbols" in the "Expressions in Commands" chapter. 
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This chapter describes the commands that can be chosen from the popup 
menus in debugger windows. Popup menus are accessed by clicking the 
right mouse button in the window. 

• BackTrace Window Popup Commands 



• Source Window Popup Commands 
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BackTrace Window Popup Commands 

• Source at Stack Level 



Source at Stack Level 

For the cursor-selected function in the BackTrace window, this command 
displays the function call in the Source window. 
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Source Window Popup Commands 

• Set Breakpoint 

• Clear Breakpoint 

• Evaluate It 

• Add to Watch 

• Run to Cursor 



Set Breakpoint 

Sets a breakpoint on the line containing the cursor. Refer to the 
Breakpoint— >Set at Cursor (ALT, B, S) command. 



Clear Breakpoint 

Deletes the breakpoint on the line containing the cursor. Refer to the 
Breakpoint— ^Delete at Cursor (ALT, B, D) command. 



Evaluate It 

Evaluates the clipboard contents and places the result in the Expression 
window. Refer to the Evaluate... (ALT, -, E) command available from the 
Expression window's control menu. 
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Add to Watch 

Adds the selected variable (that is, the variable copied to the clipboard) to 
the WatchPoint window. Refer to the Variable— >Edit... (ALT, V, E) command. 



Run to Cursor 

Executes the program up to the Source window line containing the cursor. 
Refer to the Execution— >Run to Cursor (ALT, R C) command. 
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Other Command File and Macro Commands 



This chapter describes the commands that are only available in command 
files, break macros, or buttons. 

• BEEP 

• CURSOR 

• EXIT 

• MODE SOURCE 

• MODE TRACE CLOCK 

• NOP 

• WAIT 
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BEEP 

Sounds beep during command file or break macro execution. 

Command File Command 

BEEP 
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CURSOR 

Locates the cursor at an address in the Source window. 

This command can be used to display a particular address in the Source 
window or, when used before the COME command, to run to a particular 
address. 

Command File Command 

CURSOR address 
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EXIT 

Exits, or conditionally exits, command file execution. 

Command File Command 

EXIT 

Exits command file execution. 

EXIT VAR(IABLE) address value 

Exits command file execution if the variable contains the value. 

EXIT REG ( ISTER) regname value 

Exits command file execution if the register contains the value. 

EXIT MEM(ORY) BYTE /WORD /LONG address value 

Exits command file execution if the memory location contains the value. 

EXIT 10 BYTE/WORD address value 

Exits command file execution if the I/O location contains the value. 
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MODE SOURCE 

Specifies whether you are prompted for source file paths. 

When the debugger cannot find source file information for the Source or 
Trace windows, it may prompt you for source file paths depending on the 
MODE SOURCE setting. 

You can turn off source path prompting, for example, to avoid annoying 
dialog interactions when tracing library functions for which no source files 
are available. 

Command File Command 

MOD (E) SOU(RCE) ASK (PATH) 

Prompts for source file paths when source files are not found. This is the 
default. 

MOD (E ) SOU(RCE) NOA ( SKPATH) 
Turns off prompting for source file paths. 
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MODE TRACECLOCK 

Specifies tracing of foreground or background emulation microprocessor 
operation. 

Command File Command 

MOD (E ) TRA (CECLOCK) BAC (KGROUND) 

Traces background emulation microprocessor operation. This is rarely a 
useful setting when debugging programs. 

MOD (E ) TRA (CECLOCK) BOT (H) 

Traces both background and foreground emulation microprocessor operation. 
MOD (E ) TRA (CECLOCK) USE (R) 

Traces foreground emulation microprocessor operation. This is the normal 
setting. 
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NOP 

No operation. 

This comamnd may be used to prefix comment lines in command files. 

Command File Command 

NOP 

NOP comments 
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WAIT 

Inserts wait delays during command file execution. 

Command File Command 

WAI(T) MON(ITOR) 
Waits until MONITOR status. 

WAI(T) RUN 

Waits until RUN status. 

WAI(T) UNK(NOWN) 

Waits until UNKNOWN status. 

WAI(T) SLO(W) 

Waits until SLOW CLOCK status. 

WAI(T) TGT (RESET) 

Waits until TARGET RESET status. 

WAI(T) SLE(EP) 
Waits until SLEEP status. 

WAI(T) GRA (NT) 

Waits until BUS GRANT status 

WAI(T) NOB (US) 
Waits until NOBUS status. 

WAI(T) TCO(M) 

Waits until the trace is complete. 

WAI(T) THA(LT) 

Wait until the trace is halted. 

WAI(T) TIM (E) seconds 
Waits for a number of seconds. 
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Bad RS-232 port name 

RS-232 port names must be of the form "COM<number>" where <number> is 
a decimal number from 1 to the number of communications ports your PC 
has. 

Bad RS-422 card I/O address 

The RS-422 card's I/O address must be a hexadecimal number from 100H 
through 3F8H whose last digit is 0 or 8 (100, 108, 110, etc.). Select an I/O 
address that does not conflict with the other cards in your PC. 

General RS-232 communications error 

In general, these messages indicate that the RS-232 communication has 
intermittent errors. Sometimes you will get this message if you power on the 
emulator, or when you try to connect to the emulator. In that case, simply 
retry the connection (by double-clicking on the RS232C driver line in the 
selection box); if you connect with no problems the second time, do not 
worry about the original message. 

If you get this message other than during connection, you can try to fix the 
problem by: 

• Reducing the length of the RS-232 cable between the PC and the HP 
64700. 

• Reducing the number of tasks running under windows. 

• Reducing the baud rate (the default is 19200). 

General RS-422 communications error 

In general, these messages indicate that the RS-422 communication has 
intermittent errors. Sometimes you will get this message if you power on the 
emulator, or when you try to connect to the emulator. In that case, simply 
retry the connection (by double-clicking on the HP-RS422 driver line in the 
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selection box); if you connect with no problems the second time, do not 
worry about the original message. 

If you get this message other than during connection, you can try to fix the 
problem by: 

• Reducing the number of tasks running under windows. 

• Reducing the baud rate (the default is 230400) . 

HP 64700 locked by another user 

Because it's possible to destroy another user's measurement by choosing the 
Unlock button in the error dialog box, check with the other user before 
unlocking the HP 64700. 

Note that if the other user is actually using an interface to the HP 64700, an 
Unlock request will fail. 

HP 64700 not responding 

The HP 64700 hasn't responded within the timeout period. There are various 
causes for this error. For example, a character could have been dropped 
during RS-232 communications or some network problem could have 
disrupted communications. 

Usually, you must cycle power to the HP 64700 to fix this problem. 
Incorrect DLL version 

The version of the dynamic link libraries (.DLLs) used by the Real-Time C 
Debugger does not match the version of the main program (.EXE). 

If you have two versions of debugger on your system, this can happen when 
you try to execute both of them at the same time or when you execute one 
version then the other without restarting Windows. (Once DLLs have been 
loaded into Windows memory, they stay there until Windows exits.) 

This can also happen if you have somehow loaded different versions of the 
DLLs and the executable. In this case, you must reload your software. 

Incorrect LAN Address (HP-ARPA) 

A LAN address can be one of two types: an IP address, or a host name. 
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An IP address consists of 4 digits seperated by dots. Example: 
15.6.28.0 

A hostname is a name which is related (mapped) to an IP address by a 
database. For example, the file \LANMAN.DOS\ETC\HOSTS may contain 
entries of the form: 

systeml 15.6.28.0 



Note The directory of the "hosts" file may be different on your system. 



If "HP Probe" or "DNR" (Domain Name Resolution) is available on your PC, 
those are consulted first for a mapping between the hostname and the IP 
address. If the hostname is not found by that method, or if those services are 
unavailable, the local "hosts" file is consulted for the mapping. 

Note that if "Probe" is available on your system but unable to resolve the 
address, there will be about a 15-second delay while Probe is attempting to 
find the name on the network. 

Incorrect LAN Address (Novell) 

A LAN address can be one of two types: an IP address, or a host name. 
An IP address consists of 4 digits seperated by dots. Example: 
15.6.28.0 

A hostname is a name which is related (mapped) to an IP address by a 
database. For example, the file \NET\TCP\HOSTS may contain entries of the 
form: 

systeml 15.6.28.0 



Note The directory of the "hosts" file may be different on your system. Also, all 

files defined by the PATH TCP_CFG setting under "Protocol TCPIP" in the 
NET. CFG files are searched. 
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Internal error in communications driver 

These types of errors typically occur because other applications have used up 
a limited amount of some kind of global resource (such as memory or 
sockets). 

You usually have to reboot the PC to free the global resources used by the 
communications driver. 

Internal error in Windows 

These types of errors typically occur because other applications have used up 
a limited amount of some kind of global resource (such as memory, sockets, 
tasks, or handles). 

You usually have to reboot the PC to free the global resources used by 
Windows. 

Interrupt execution (during run to caller) 

The Return dialog box appears when running to the caller of a function and 
the caller is not found within the number of milliseconds specified by 
StepTimerLen in the debugger application's ".INI" file. 

You can cancel the run to caller command by choosing the STOP button 
which causes program execution to stop, the breakpoint to be deleted, and 
the processor to transfer to the RUNNING IN USER PROGRAM status. 

Interrupt execution (during step) 

The Step dialog box appears when stepping a source line or assembly 
instruction and the source line or instruction does not execute within the 
number of milliseconds specified by StepTimerLen in the debugger 
application's ".INI" file. 

You can cancel the step command by choosing the STOP button which 
causes program execution to stop, the breakpoint to be deleted, and the 
processor to transfer to the RUNNING IN USER PROGRAM status. 

Interrupt execution (during step over) 

The Step dialog box appears when stepping over a function or subroutine and 
the function or subroutine does not execute within the number of 
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milliseconds specified by StepTimerLen in the debugger application's ".INI" 
file. 

You can cancel the step over command by choosing the STOP button which 
causes program execution to stop, the breakpoint to be deleted, and the 
processor to transfer to the RUNNING IN USER PROGRAM status. 

Invalid transport name 

The transport name chosen does not match any of the possible transport 
names (RS232C, HP-ARPA, Novell-WP, or HP-RS422). 

The transport name can be specified either on the command line with the -t 
option or in the .INI file: 

[Port] 

Transport=<transport name> 

Choosing an appropriate transport in the dialog box that follows this error 
will correct the entry in the .INI file, but if the error is in the command line 
option, you need to modify the command line (by using the "Properties..." 
command in the Program Manager). 

LAN buffer pool exhausted 

The LAN buffer pool is used as a temporary buffer between when the 
debugger sends data and when the LAN actually sends it. When this pool is 
exhausted, debugger cannot send any data across the LAN. 

The size of the sockets buffer pool is configured in the network installation 
procedure. 

LAN communications error 

This occurs for any kind of LAN error. 

Refer to the documentation for your LAN software for descriptions of the 
types of problems that can cause LAN errors. 

LAN MAXSENDSIZE is too small 

This means that you have configured your LAN with a value or 
MAXSENDSIZE that is less than 100 bytes. Note that the default is 1024 
bytes. 
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The Real-Time C Debugger requires at least 100 bytes for this parameter. 

To fix this, change the following entry in your PROTOCOL.INI file and reboot 
your PC: 

[SOCKETS] 
MAXSENDSIZE 

LAN Socket error 

A TCP-level error has occurred on the network. See your network 
administrator. 

No initialization (.INI) file was found 

For example, if the application is Bxxxx.EXE, the Bxxxx.INI file is expected 
to be found in the same directory. 

To fix this problem, you can re-create the initialization file by copying 
information from the default file, for example BxxxxDEF.INI, which is in the 
same directory as the application. If you cannot find the default initialization 
file either, you can re-install the debugger software. 

Out of Windows timer resources 

The debugger is not able to acquire the timer resources it needs. 

There are a limited number of timer resources in Windows. You may be able 
to free timer resources by closing other applications. 

Out of DOS Memory for LAN buffer 

This means that there is not enough memory in the lower 1 Mbyte of address 
space (that is, conventional memory) for the LAN driver to allocate a buffer 
to communicate with the LAN TSR. 

When you are in windows, and execute the DOS command "mem", you 
cannot see the memory that is in the lower 1 Mbyte that is used by the 
windows program. If you have the Microsoft program "heapwalker", you can 
use it to see what programs have allocated space in the address range 0 thru 
FFFFF. 
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To fix this, you can: 

• Reduce the number of TSRs running on your PC (before Windows starts) 
that use conventional memory. 

• Reconfigure your network to have fewer sockets or modules loaded, or to 
be configured for fewer total connections. 

• Use a different memory manager to reduce your network memory usage, 
such as QEMM. 

PC is out of RAM memory 

The debugger is not able to acquire the memory it needs because other 
applications are using it or because of fragmented memory. 

You may be able to free memory by closing other applications, or you might 
have to reboot the PC to cause memory to be unfragmented. 

Timed out during communications 

The HP 64700 hasn't responded within the timeout period. There are various 
causes for this error. For example, a character could have been dropped 
during RS-232 communications or some network problem could have 
disrupted communications. 

The timeout period for reading and writing to the HP 64700 is defined by 
TimeoutSeconds in either the [RS232C], [HP-ARPA] , [Novell-WP], or 
[HP-RS422] section of the Bxxxx.INI file. For example, if you are using the 
RS-232C transport: 

[RS232C] 

Timeout Seconds =<seconds> 

The number of seconds can be between 1 and 32767. The default is 20 
seconds. 

If you're using RS-232C or RS-422 transport ... 

The TimeoutSeconds value is also used for connecting to the HP 64700 (as 
well as for reading and writing) . 

If you're using HP-ARPA or Novell-WP transport ... 

If there are several gateways or bridges between the PC and the emulator, 
larger values of TimeoutSeconds may be reasonable. 
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The timeout period for connecting to the HP 64700 is defined in the 
PROTOCOL.INI file. 

[TCPIP_XFR] 

TCPCONNTIMEOUT=<seconds> 

The default connection timeout is 30 seconds. 
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Concept Guide 

Topics that explain concepts and apply them to advanced tasks. 
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Concepts 



This chapter describes the following topics. 

• Debugger Windows 

• Compiler/Assembler Specifications 

• Monitor Programs 

• Trace Signals and Predefined Status Values 
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Debugger Windows 

This section describes the following debugger windows: 

• A-D Conversion Registers 

• BackTrace 

• Basic Registers 

• Button 

• D-A Conversion Registers 

• Expression 

• Interrupt Control Registers 

• I/O 

• Memory 

• Mode Registers 

• Port Registers 

• Pulse Motor Control Registers 

• Source 

• Status 

• Symbol 

• Timer Registers 

• Trace 

• UARTO Registers 

• UART1 Registers 

• Watchdog Timer Registers 

• WatchPoint 
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The A-D Conversion Registers Window 

The A-D Conversion Registers window displays contents of A-D Conversion 
Registers. 



A-D conversion Registers 



NAME UALUE DESCRIPTION 



ADCR=07 


A 


-D 


ADSPSR=03 


A 


-D 


ADR0=08 


A 


-D 


ADR1 =85 


A 


-D 


ADR2=80 


A 


-D 


ADR3=A0 


A 


-D 


ADR4=00 


A 


-D 


ADR5=8A 


A 


-D 


ADR6=00 


A 


-D 


ADR7=80 


A 


-D 



register 1 
register 2 
register 3 
register 4 
register 5 
register 6 
A-D register 7 



Each register is represented by a row which holds a mnemonic name, a 
current value, and a description of the register contents. 

The registers may be edited by either single clicking or double-clicking on the 
value. A single click puts you in a mode where the left or right arrow keys 
may be used for placement of the cursor. Double-clicking puts you in one of 
two modes; either a Register Bit Fields dialog pops up or the value is 
highlighted. When the value is highlighted, the backspace key will erase the 
value and a completely new value may be entered. This mode is applicable to 
registers where the value is considered a single number and is not divided by 
any bit-fields. 

The A-D Conversion Registers window's contents are updated periodically 
when the processor is running the user program and monitor intrusion is 
allowed. 

A temporary break from the user program into the monitor program must 
occur in order for the debugger to update or modify register contents. If it's 
important that the user program execute without these types of 
interruptions, you should disallow monitor intrusion. 
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See Also 

Displaying and Editing Registers in the "Debugging Programs" chapter. 
A-D Conversion Registers 

Register Description Size Bit Edit 



eadcr 


A- 


-D 


control 




1 


adspsr 


A- 


-D 


sweep pin 


1 




selection 






adrO 


A- 


-D 


register 


0 


1 


adrl 


A- 


-D 


register 


1 


1 


adr2 


A- 


-D 


register 


2 


1 


adr3 


A- 


-D 


register 


3 


1 


adr4 


A- 


-D 


register 


4 


1 


adr5 


A- 


-D 


register 


5 


1 


adr6 


A- 


-D 


register 


6 


1 


adr6 


A- 


-D 


register 


7 


1 
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The BackTrace Window 

The BackTrace window displays the function associated with the current 
program counter value and this function's caller functions backward. The 
current arguments of these functions are also displayed. 




The BackTrace window is updated when program execution stops at an 
occurrence of breakpoint, break, or Step command. 

The BackTrace window lets you copy text strings, to the clipboard by 
double-clicking words or by holding down the left mouse button and dragging 
the mouse pointer. 

By clicking the right mouse button in the BackTrace window, you can access 
the Source at Stack Level popup menu command. Cursor-select a function in 
the BackTrace window and choose this command to display (in the Source 
window) the code that called the function. 

See Also 

"BackTrace Window Popup Commands" in the "Window Popup Commands" 
chapter. 
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The Basic Register Windows 

The Basic Register windows display the contents of registers. 



Basic Registers 



NAME UALUE DESCRIPTION 




A 


=205C 


Accumulator A 


B 


=0000 


Accumulator B 


X 


=0000 


Index X 


y 


=0000 


Index V 


SP 


=2251 


Stack Pointer 


DT 


=00 


Data Bank 


PG 


=00 


Program Bank 


PC 


=80D1 


Program Counter 


DPR 


=205C 


Direct Page 


PS 


=0004 


Processor Status 


'. i 








Each register is represented by a row which holds a mnemonic name, a 
current value, and a description of the register contents. 

You can modify register contents by double-clicking on the value, using the 
keyboard to type in the new value, and pressing the Return key. 

The Basic Registers window's contents are updated periodically when the 
processor is running the user program and monitor intrusion is allowed. 

A temporary break from the user program into the monitor program must 
occur in order for the debugger to update or modify register contents. If it's 
important that the user program execute without these types of 
interruptions, you should disallow monitor intrusion. 



See Also 

Displaying and Editing Registers in the "Debugging Programs" chapter. 

Registers Window Commands in the "Window Control Menu Commands' 
chapter. 
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The Button Window 

The Button window contains user-defined buttons that, when chosen, 
execute debugger commands or command files. 





Button 






J Start j Run 


Step |StepOvr 


StepOut 


Break 


FnFlow 



The Button window's control menu provides the Edit... (ALT, -, E) 
command which lets you add and delete buttons from the window. 

See Also 

"Using Command Files" in the "Using the Debugger Interface" chapter. 

"Button Window Commands" in the "Window Control Menu Commands' 
chapter. 



The D-A Conversion Registers Window 

The D-A Conversion Registers window displays contents of D-A Conversion 
Registers. 



Q D-A Convers 


ion Registers 




a. | 


NAME UALUE 


DESCRIPTION 






DAR0=00 


D-A register 


0 




DAR1 =00 


D-A register 


1 










+ 1 



Each register is represented by a row which holds a mnemonic name, a 
current value, and a description of the register contents. 

The registers may be edited by either single clicking or double-clicking on the 
value. A single click puts you in a mode where the left or right arrow keys 
may be used for placement of the cursor. Double-clicking puts you in one of 
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two modes; either a Register Bit Fields dialog pops up or the value is 
highlighted. When the value is highlighted, the backspace key will erase the 
value and a completely new value may be entered. This mode is applicable to 
registers where the value is considered a single number and is not divided by 
any bit-fields. 

The D-A Conversion Registers window's contents are updated periodically 
when the processor is running the user program and monitor intrusion is 
allowed. 

A temporary break from the user program into the monitor program must 
occur in order for the debugger to update or modify register contents. If it's 
important that the user program execute without these types of 
interruptions, you should disallow monitor intrusion. 

See Also 

Displaying and Editing Registers in the "Debugging Programs" chapter. 

Register Window Commands in the "Window Control Menu Commands" 
chapter. 

D-A Conversion Registers 

Register Description Address Size Bit Edit 

darO D-A register 0 1AH 1 

darl D-A register 1 1CH 1 



407 



Chapter 13: Concepts 
Debugger Windows 



The Expression Window 

The Expression window displays the results of the EVALUATE commands in 
command files or break macros. 





Expression 0 






: 101 <65H> 'e' 


♦ 




32 <20H> ' ' 




*nes 


112 <70H> 'p' 




*mes : 


: 114 <72H> 'r' 




*nes 


: 111 <6FH> 'o' 




*nes : 


103 <67H> 'g' 


*mes : 


: 114 <72H> 'r' 




*mes 


: 97 <61H> 'a' 




*ne s 


109 <6DH> 'n' 






: 85 <55H> 'U' 






: 112 <70H> 'p' 








♦ 



When a variable name is specified with the EVALUATE command, the 
Expression window displays the evaluation of the variable. When a quoted 
string of ASCII characters is specified with the EVALUATE command, the 
Expression window displays the string. 

The Expression window's control menu provides the Evaluate... (ALT, -, E) 
command which lets you evaluate expressions and see the results in the 
window. 

See Also 

"Expression Window Commands" in the "Window Control Menu Commands" 
chapter. 
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The Interrupt Control Registers Window 

The Interrupt Control Registers window displays contents of Interrupt 
Control Registers. 



Interrupt Control Registers 



NAME UflLUE DESCRIPTION 



ODCICR 


=00 


fl-D conversion intr 


U0TICR 


=00 


UART0 


Tx 


intr 


ctrl 


U0RICR 


=00 


UART0 


Rx 


intr 


Ctrl 


U1TICR 


=00 


U0RT1 


Tx 


intr 


ctrl 


U1RICR 


=00 


U0RT1 


Rx 


intr 


ctrl 


TA0ICR 


=00 


Timer 


A0 


intr 


ctrl 


TA1ICR 


=00 


Timer 


01 


intr 


ctrl 


T02ICR 


=00 


Timer 


02 


intr 


ctrl 


TA3ICR 


=00 


Timer 


03 


intr 


ctrl 


TA4ICR 


=00 


Timer 


04 


intr 


ctrl 


TB0ICR 


=00 


Timer 


B0 


intr 


ctrl 


TBI ICR 


=00 


Timer 


Bl 


intr 


ctrl 


TB2ICR 


=00 


Timer 


B2 


intr 


ctrl 


INT0ICR 


=00 


/INT0 


intr ctrl 


INT1ICR 


=00 


/INT1 


intr ctrl 


INT2ICR 


=00 


/INT2 


intr ctrl 



J2I 



Each register is represented by a row which holds a mnemonic name, a 
current value, and a description of the register contents. 

The registers may be edited by either single clicking or double-clicking on the 
value. A single click puts you in a mode where the left or right arrow keys 
may be used for placement of the cursor. Double-clicking puts you in one of 
two modes; either a Register Bit Fields dialog pops up or the value is 
highlighted. When the value is highlighted, the backspace key will erase the 
value and a completely new value may be entered. This mode is applicable to 
registers where the value is considered a single number and is not divided by 
any bit-fields. 

The Interrupt Control Registers window's contents are updated periodically 
when the processor is running the user program and monitor intrusion is 
allowed. 

A temporary break from the user program into the monitor program must 
occur in order for the debugger to update or modify register contents. If it's 
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important that the user program execute without these types of 
interruptions, you should disallow monitor intrusion. 

See Also 

Displaying and Editing Registers in the "Debugging Programs" chapter. 

Register Window Commands in the "Window Control Menu Commands 1 
chapter. 

Interrupt Control Registers 

Register Description Address Size Bit Edit 



adcicr 


A-D conversion intr 


70H 


1 


0 




Ctrl 














uOticr 


UARTO 


Tx 


intr 


Ctrl 


71H 


1 


0 


uOricr 


UARTO 


Rx 


intr 


Ctrl 


72H 


1 


0 


ulticr 


UART1 


Tx 


intr 


Ctrl 


73H 


1 


0 


ulricr 


UART1 


Rx 


intr 


Ctrl 


74H 


1 


0 


taOicr 


Timer 


AO 


intr 


Ctrl 


75H 


1 


0 


talicr 


Timer 


Al 


intr 


Ctrl 


76H 


1 


0 


ta2icr 


Timer 


A2 


intr 


Ctrl 


77H 


1 


0 


ta3icr 


Timer 


A3 


intr 


Ctrl 


78H 


1 


0 


ta4icr 


Timer 


A4 


intr 


Ctrl 


79H 


1 


0 


tbOicr 


Timer 


BO 


intr 


Ctrl 


7 AH 


1 


0 


tblicr 


Timer 


Bl 


intr 


Ctrl 


7BH 


1 


0 


tb2icr 


Timer 


B2 


intr 


Ctrl 


7CH 


1 


0 


intOicr 


/INTO 


intr Ctrl 


7DH 


1 


0 


intlicr 


/INT1 


intr ctrl 


7EH 


1 


0 


int2icr 


/INT2 


intr Ctrl 


7FH 


1 


0 
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The I/O Window 

The I/O window displays the contents of the I/O locations. 





I/O 




a. E; 


0002000 m 

















You can modify the contents of I/O locations by double-clicking on the value, 
using the keyboard to type in the new value, and pressing the Return key. 

The I/O window contents are updated periodically when the processor is 
running the user program. 

If a location is in target system memory, a temporary break from the user 
program into the monitor program must occur in order for the debugger to 
update or modify that location's contents. If it's important that the user 
program execute without these types of interruptions, you should disallow 
monitor intrusion. Even when monitor intrusion is allowed, you can stop 
temporary breaks during the window update by turning polling OFF. 

See Also 

"Displaying and Editing I/O Locations" in the "Debugging Programs" chapter. 
"I/O Window Commands" in the "Window Control Menu Commands" chapter. 
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The Memory window displays memory contents. 











Memory 






1 ^ 




0002000 


D6 


82 


EF 


82 


01 


00 


01 


00 




♦ J 


0002008 


00 


00 


54 


68 


69 


73 


20 


69 


..This i 




0002010 


73 


20 


61 


20 


73 


61 


6D 


70 


s a samp 




0002018 


6C 


65 


20 


70 


72 


6F 


67 


72 


le progr 




0002020 


61 


6D 


00 


00 


00 


00 


00 


00 






0002028 


00 


00 


00 


00 


00 


00 


00 


00 






0002030 


00 


00 


01 


00 


75 


50 


50 


45 


uPPE 




0002038 


52 


20 


41 


4E 


44 


20 


6C 


4F 


R AND 10 




0002040 


57 


45 


52 


20 


63 


41 


53 


45 


WEP. cASE 




0002048 


20 


63 


4F 


4E 


56 


45 


52 


53 


cONUERS 




0002050 


49 


4F 


4E 


00 


00 


00 


00 


00 


ION 




0002058 


00 


00 


00 


00 


00 


00 


00 


00 






0002060 


00 


00 


00 


00 


00 


00 


00 


00 






0002068 


00 


00 


00 


00 


00 


00 


00 


00 






0002070 


00 


00 


00 


00 


00 


00 


00 


00 






0002078 


00 


00 


00 


00 


00 


00 


00 


00 






0002080 


00 


00 


00 


00 


00 


00 


00 


00 






0002088 
0002090 


00 
00 


00 

00 


00 
00 


00 
00 


00 
00 


00 
00 


00 
00 


00 
00 




□ 



The Memory window has control menu commands that let you change the 
format of the memory display and the size of the locations displayed or 
modified. When the absolute (single -column) format is chosen, symbols 
corresponding to addresses are displayed. When data is displayed in byte 
format, ASCII characters for the byte values are also displayed. 

When Memory window polling is turned ON, you can modify the addresses 
displayed or contents of memory locations by double -clicking on the address 
or value, using the keyboard to type in the new address or value, and 
pressing the Return key. 

The Memory window contents are updated periodically when the processor is 
running the user program. 

If a location is in target system memory, a temporary break from the user 
program into the monitor program must occur in order for the debugger to 
update or modify that location's contents. If it's important that the user 
program execute without these types of interruptions, you should disallow 
monitor intrusion. Even when monitor intrusion is allowed, you can stop 
temporary breaks during the window update by turning polling OFF. 
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See Also 

"Displaying and Editing Memory" in the "Debugging Programs" chapter. 

"Memory Window Commands" in the "Window Control Menu Commands" 
chapter. 



The Mode Registers Window 

The Mode Registers window displays contents of Mode Conversion Registers. 



Each register is represented by a row which holds a mnemonic name, a 
current value, and a description of the register contents. 

The registers may be edited by either single clicking or double-clicking on the 
value. A single click puts you in a mode where the left or right arrow keys 
may be used for placement of the cursor. Double-clicking puts you in one of 
two modes; either a Register Bit Fields dialog pops up or the value is 
highlighted. When the value is highlighted, the backspace key will erase the 
value and a completely new value may be entered. This mode is applicable to 
registers where the value is considered a single number and is not divided by 
any bit-fields. 

The Mode Conversion Registers window's contents are updated periodically 
when the processor is running the user program and monitor intrusion is 
allowed. 

A temporary break from the user program into the monitor program must 
occur in order for the debugger to update or modify register contents. If it's 
important that the user program execute without these types of 
interruptions, you should disallow monitor intrusion. 




NAME 



PMR0=03 
PMR1=00 



UALUE DESCRIPTION 



Processor node 
Processor node 
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See Also 

Displaying and Editing Registers in the "Debugging Programs" chapter. 

Register Window Commands in the "Window Control Menu Commands' 
chapter. 

Mode Registers 

Register Description Address Size Bit Edit 

pmr Processor mode 5EH 1 0 

pmrO Processor mode 0 5EH 1 0 

pmrl Processor mode 1 5FH 1 0 
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The Other Registers Window 

The Other Registers window displays contents of M37734 unique Registers. 







Other Registers Q 




NAME 


UALUE 


DESCRIPTION 




OCC 
P5FC 
STC 
S 


=00 
=00 


Oscillating circuit control 
Port P5 control function contr 
Serial transmit control 
Special 


T 



Each register is represented by a row which holds a mnemonic name, a 
current value, and a description of the register contents. 

The registers may be edited by either single clicking or double-clicking on the 
value. A single click puts you in a mode where the left or right arrow keys 
may be used for placement of the cursor. Double-clicking puts you in one of 
two modes; either a Register Bit Fields dialog pops up or the value is 
highlighted. When the value is highlighted, the backspace key will erase the 
value and a completely new value may be entered. This mode is applicable to 
registers where the value is considered a single number and is not divided by 
any bit-fields. 

The Other Registers window's contents are updated periodically when the 
processor is running the user program and monitor intrusion is allowed. 

A temporary break from the user program into the monitor program must 
occur in order for the debugger to update or modify register contents. If it's 
important that the user program execute without these types of 
interruptions, you should disallow monitor intrusion. 

See Also 

Displaying and Editing Registers in the "Debugging Programs" chapter. 

Register Window Commands in the "Window Control Menu Commands" 
chapter. 
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Other Registers 



Register 


Description 


Address 


Size 


Bit : 


occ 


Oscillating circuit 


6CH 


1 


0 




control 








p5f c 


Port P5 function 


6DH 


1 


0 




control 








stc 


Serial transmit 


6EH 


1 


0 




control 








s 


Special 


6FH 


1 


0 
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The Port Registers Window 

The Port Registers window displays contents of Port Registers. 



Port Registers 



NAME UflLUE DESCRIPTION 



P0 


=00 


Port 


P0 






PI 


=00 


Port 


Pi 






P0DDR 


=00 


Port 


P0 


data 


direction 


P1DDR 


=00 


Port 


Pi 


data 


direction 


P2 


=00 


Port 


P2 






P3 


=00 


Port 


P3 






P2DDR 


=00 


Port 


P2 


data 


direction 


P3DDR 


=00 


Port 


P3 


data 


direction 


P4 


=03 


Port 


P4 






P5 


=00 


Port 


P5 






P4DDR 


=00 


Port 


P4 


data 


direction 


P5DDR 


=00 


Port 


P5 


data 


direction 


P6 


=00 


Port 


P6 






P7 


=00 


Port 


P7 






P6DDR 


=00 


Port 


P6 


data 


direction 


P7DDR 


=00 


Port 


P7 


data 


direction 


P8 


=00 


Port 


P8 






P8DDR=00 


Port 


P8 


data 


direction 



Each register is represented by a row which holds a mnemonic name, a 
current value, and a description of the register contents. 

The registers may be edited by either single clicking or double-clicking on the 
value. A single click puts you in a mode where the left or right arrow keys 
may be used for placement of the cursor. Double-clicking puts you in one of 
two modes; either a Register Bit Fields dialog pops up or the value is 
highlighted. When the value is highlighted, the backspace key will erase the 
value and a completely new value may be entered. This mode is applicable to 
registers where the value is considered a single number and is not divided by 
any bit-fields. 

The Port Registers window's contents are updated periodically when the 
processor is running the user program and monitor intrusion is allowed. 

A temporary break from the user program into the monitor program must 
occur in order for the debugger to update or modify register contents. If it's 
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important that the user program execute without these types of 
interruptions, you should disallow monitor intrusion. 

See Also 

Displaying and Editing Registers in the "Debugging Programs" chapter. 

Register Window Commands in the "Window Control Menu Commands 1 
chapter. 



Port Registers 



Recji st er 


Description Address 


oize 


OIL LU1L 


pu 


Port 


PO 02H 


-i 
i 




PI 


Port 


PI 03H 


j. 




pUddr 


Port 


PO 04H 


1 


U 




data 


direction 






plddr 


Port 


PI 05H 


1 


0 




data 


direction 






p2 


Port 


P2 06H 


1 




P 3 


Port 


P3 07H 


1 




p2ddr 


Port 


P2 08H 


1 


0 




data 


direction 






p3ddr 


Port 


P3 09H 


1 


0 




data 


direction 






P 4 


Port 


P4 OAH 


1 




P 5 


Port 


P5 OBH 


1 




p4ddr 


Port 


P4 OCH 


1 


0 




data 


direction 






p5ddr 


Port 


P5 ODH 


1 


0 




data 


direction 






p6 


Port 


P6 OEH 


1 




P 7 


Port 


P7 OFH 


1 




p6ddr 


Port 


P6 10H 


1 


0 




data 


direction 






p7ddr 


Port 


P7 11H 


1 


0 




data 


direction 






P 8 


Port 


P8 12H 


1 




p8ddr 


Port 


P6 14H 


1 


0 




data 


direction 
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The Pulse Motor Control Registers Window 

The Pulse Motor Control Registers window displays contents of Pulse Motor 
Control Registers. 



Pulse Motor Control Registers 



NAME UhLUE DESCRIPTION 



WOMR felt) Uaueforn output node 
PODR1=00 Pulse output data 1 
PODR0=00 Pulse output data 0 



Each register is represented by a row which holds a mnemonic name, a 
current value, and a description of the register contents. 

The registers may be edited by either single clicking or double-clicking on the 
value. A single click puts you in a mode where the left or right arrow keys 
may be used for placement of the cursor. Double-clicking puts you in one of 
two modes; either a Register Bit Fields dialog pops up or the value is 
highlighted. When the value is highlighted, the backspace key will erase the 
value and a completely new value may be entered. This mode is applicable to 
registers where the value is considered a single number and is not divided by 
any bit-fields. 

The Pulse Motor Control Registers window's contents are updated 
periodically when the processor is running the user program and monitor 
intrusion is allowed. 

A temporary break from the user program into the monitor program must 
occur in order for the debugger to update or modify register contents. If it's 
important that the user program execute without these types of 
interruptions, you should disallow monitor intrusion. 

See Also 

Displaying and Editing Registers in the "Debugging Programs" chapter. 

Register Window Commands in the "Window Control Menu Commands" 
chapter. 
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Pulse Motor Control Registers 

Register Description Address Size Bit Edit 



womr 


Waveform 


62H 


1 




output mode 






dtt 


Dead-time timer 


63H 


1 


podrl 


Pulse output 


64H 


1 




datal 






podrO 


Pulse output 


65H 


1 




dataO 
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The Source Window 

The Source window displays source files, optionally with disassembled 
instructions intermixed. 

The Source window contains a cursor whose position is used when setting or 
deleting breakpoints or break macros or when running the program up to a 
certain line. 

The Source window lets you copy strings, usually variable or function names 
to be used in commands, to the clipboard by double-clicking words or by 
holding down the left mouse button and dragging the mouse pointer. 

The Source window also provides commands in the control menu that let 
you select whether disassembled instruction mnemonics should appear 
intermixed with the C source code. 

By clicking the right mouse button in the Source window, you can also access 
popup menu commands. 



Filename 



Source 



c : \hp\rtc\m7700\de no \sample\s ample . c 



80063 
00080e3 
80064 
80065 
BP 80066 



BP 00080e6 



0008 0e 9 

0008 0e a 

80067 

00080ed 

00080f0 

0008 0f 3 

00080f6 

80068 

80069 

80070 



init_data<>; 
0x200880 JSR PG:init_data 
while<l> 

< 

convert (inessaqe id); 



0xac0620 LDV DT:2006H 



0xd8 CLM 

0x209480 JSR PG:conuert 

message _id = next_message<message_id> ; 
0xac0620 LDV DT:2006H 

JSR PG:next_message 
STh fl»DT:2006H 
BRA 0080E6H 



0x20cb80 
0x8d0620 
0x8 0ee 

> 

> 
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Filename The name of the displayed source file appears at the top of 

the window. 

Source Lines C source code is displayed when available. Source lines are 
preceded by the corresponding line numbers. 

When programs are written in assembly language or when 
no C source code is available, disassembled instruction 
mnemonics are displayed. 

Disassembled In the Mnemonic Display mode, disassembled instruction 
Instructions mnemonics are intermixed with the source lines. 

Disassembled lines contain address, data, and mnemonic 

information. 

When symbolic information is available for the address, the 
corresponding symbol line precedes the disassembled 
instruction, displayed in the module_name\\symbol_name 
format. 

Current PC The line associated with the current program counter is 
highlighted. 

Scroll Bars For C source files, the display scrolls within the source 

files. For assembly language programs or programs for 
which no source code is available, the display scrolls for all 
the memory space. 

"BP" Marker The breakpoint marker, "BP", appears at the beginning of 
the breakpoint lines or break macro lines. 

Execution The accessed (executed) lines are highlighted when 

Coverage program execution coverage is enabled. 

Break Macro Decimal points following line numbers or addresses 
Lines indicate break macro lines. 



Note 



When programs are stored in target system memory and the emulator is 
running in real-time, source code cannot be displayed. 
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See Also 

"Loading and Displaying Programs", 

"Stepping, Running, and Stopping the Program", 

"Using Breakpoints and Break Macros" in the "Debugging Programs" chapter, 
and Making Coverage Measurements in the "Debugging Programs" chapter. 

"Source Window Commands" in the "Window Control Menu Commands" 
chapter. 

"Source Window Popup Commands" in the "Window Popup Commands" 
chapter. 



The Status Window 

The Status window shows the emulator status, the trace status, and the 
scope of the current program counter value. 



••■■■■■•'•J^"" — - — 


Status 


1 ^ 


a. 


EMULATOR: 


RUNNING IN USER PROGRAM 






TRACE: 


COMPLETE 






SCOPE: 


sanple\\conwert_case 







Emulation Processor Status Messages 

EMULATION RESET 

The emulation processor is being held in the reset state by the emulator. 
RUNNING IN MONITOR 

The emulation processor is executing the monitor program. 
RUNNING IN USER PROGRAM 

The emulation processor is executing the user program. 
RUNNING REALTIME IN USER PROGRAM 

The emulation processor is executing the user program in the real-time mode 
where: 

• Any command that would temporarily interrupt user program execution 
is disabled. 
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• Any on-screen information that would be periodically updated by 

temporarily interrupting user program execution (target system memory 
or register contents, for example) is disabled. 

WAITING FOR TARGET RESET 

The emulation processor is waiting for a RESET signal from the target 
system. User program execution starts on reception of the RESET signal. 

SLOW CLOCK 

No proper clock pulse is supplied from the external clock. 
EMULATION RESET BY TARGET 

The emulation processor is being held in a reset state by a RESET signal from 
the target system. 

BUS GRANT TO TARGET SYSTEM DEVICE 

The bus is granted to some device in the target system. 

NO BUS CYCLE 

The bus cycle is too slow or no bus cycle is provided. 
HALTED 

The emulation processor has halted. 
UNKNOWN STATE 

The emulation processor is in an unknown state. 
Other Emulator Status Messages 

The Status window may also contain status messages other than the 
emulation processor status messages described above: 

BREAK POINT HIT AT module_name#line_number 

The breakpoint specified in the source code line was hit and program 

execution stopped at "line_number" in "module". 

BREAKPOINT HIT AT address 

The breakpoint specified in the assembled line was hit and program 
execution stopped at "address". 

UNDEFINED BREAKPOINT at address 

The breakpoint instruction occurred at "address", but it was not inserted by a 
breakpoint set command. 
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WRITE TO ROM BREAK 

Program execution has stopped due to a write to location mapped as ROM. 
These types of breaks must be enabled in the emulator configuration. 

ACCESS TO GUARD BREAK 

Program execution has stopped due to a write to a location mapped as 
guarded memory. 

TRACE TRIGGER BREAK 

The analyzer trigger caused program execution to break into the monitor (as 
specified by selecting the Break On Trigger option in the trace setting dialog 
box). 

Trace Status Messages 

TRACE RUNNING 

The trace has been started and trace memory has yet to be filled; this could 
be because the trigger condition has not occurred or, if the trigger condition 
has occurred, there have not been enough states matching the store 
condition to fill trace memory. Contents of the trace buffer cannot be 
displayed during the TRACE RUNNING status; you must halt the trace before 
you can display the contents of the trace buffer. 

TRACE HALTED 

The trace was halted before the trace buffer was filled. The status indicates 
that the trace was halted immediately after the emulator powerup, or that the 
trace was force-terminated by the user. In the TRACE HALTED status, the 
analyzer displays the contents of the trace buffer before the halt in the Trace 
window. 

TRACE COMPLETE 

The trace completed because the trace buffer is full. The results are 
displayed in the Trace window. 
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The Symbol Window 

The Symbol window displays information on the following types of symbols: 

• Modules 

• Functions 

• Global symbols 

• Local symbols 

• Global Assembler symbols 

• Local Assembler symbols 

• User-defined symbols 

The Symbol window has control menu commands that lets you display 
various types of symbols, add or delete user-defined symbols, copy Symbol 
window information, or search for symbols that contain a particular string. 

The Symbol window lets you copy symbols to the clipboard by clicking the 
left mouse button. The symbol information can then be pasted from the 
clipboard in other commands. 







Symbol 




Funct ions 




int 






convert 


int 




00004ac . .000050f 


convert _case 


int 




0000510. .0000547 


in it_data 


int 




000046a. .00004ab 


main 


int 






next_message 


int 




000055c - . 000056f 



Symbols are displayed with "type" and "address" values where appropriate. 

Up to 2000 modules, 4000 functions, or 4000 symbols can be shown in the 
Symbol window. When your program has more symbols than allowed, it's 
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hard to predict which symbols will not be shown due to the way they're read 
from the object file. 

See Also 

"Displaying Symbol Information" in the "Debugging Programs" chapter. 

"Symbol Window Commands" in the "Window Control Menu Commands" 
chapter. 
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The Timer Registers Window 

The Timer Registers window displays contents of Timer Registers. 



IP Timer Registers |! 




NAME UALUE 


DESCRIPTION 




CSF=00 


Count 


start flag 




OSSF=00 


One shot 


start flag 




UDF=00 


Up-downf lag 
Tinier A0 




TA0=FF7F 




TA1=F7FF 


Timer 


Al 






TA2=FFFF 


Timer 


A2 






TA3=FFFF 


Timer 


A3 






TA4=FFFF 


Timer 


A4 






TB0=FF9F 


Timer 


B0 






TBI =FFFA 


Timer 


Bl 






TB2=FF96 


Timer 


B2 






TA0MR=00 


Timer 


A0 


mode 




TA1MR=00 


Timer 


Al 


mode 




TA2MR=00 


Timer 


A2 


mode 




TA3MR=00 


Timer 


A3 


mode 




TA4MR=00 


Timer 


A4 


mode 




TB0MR=20 


Timer 


B0 


mode 


TBI MR 20 


Timer 


Bl 


mode 11 


TB2MR=20 


Timer 


B2 


mode 



Each register is represented by a row which holds a mnemonic name, a 
current value, and a description of the register contents. 

The registers may be edited by either single clicking or double-clicking on the 
value. A single click puts you in a mode where the left or right arrow keys 
may be used for placement of the cursor. Double-clicking puts you in one of 
two modes; either a Register Bit Fields dialog pops up or the value is 
highlighted. When the value is highlighted, the backspace key will erase the 
value and a completely new value may be entered. This mode is applicable to 
registers where the value is considered a single number and is not divided by 
any bit-fields. 

The Timer Registers window's contents are updated periodically when the 
processor is running the user program and monitor intrusion is allowed. 

A temporary break from the user program into the monitor program must 
occur in order for the debugger to update or modify register contents. If it's 
important that the user program execute without these types of 
interruptions, you should disallow monitor intrusion. 
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See Also 

Displaying and Editing Registers in the "Debugging Programs" chapter. 

Register Window Commands in the "Window Control Menu Commands" 
chapter. 

Timer Registers 

Register Description Address Size Bit Edit 



csf 


Count 


start flag 


40H 


1 


0 


ossf 


One shot 


start flag 


42H 


1 


0 


udf 


Up-down 


flag 


44H 


2 




taO 


Timer 


AO 




46H 


2 




taO 


Timer 


Al 




48H 


2 




taO 


Timer 


A2 




4 AH 


2 




taO 


Timer 


A3 




4CH 


2 




taO 


Timer 


A4 




4EH 


2 




taO 


Timer 


BO 




50H 


2 




taO 


Timer 


Bl 




52H 


2 




taO 


Timer 


B2 




54H 


2 




taOmr 


Timer 


AO 


mode 


56H 


1 


0 


talmr 


Timer 


Al 


mode 


57H 


1 


0 


ta2mr 


Timer 


A2 


mode 


58H 


1 


0 


ta3mr 


Timer 


A3 


mode 


59H 


1 


0 


ta4mr 


Timer 


A4 


mode 


5 AH 


1 


0 


tbOmr 


Timer 


BO 


mode 


5BH 


1 


0 


tblmr 


Timer 


Bl 


mode 


5CH 


1 


0 


tb2mr 


Timer 


B2 


mode 


5DH 


1 


0 
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The Trace Window 

The Trace window displays trace results and shows source code lines that 
correspond to the execution captured by the analyzer. Optionally, bus cycle 
states can be displayed along with the source code lines. 

The Trace window has control menu commands that let you display bus 
cycles, specify whether count information should be accumulated or relative, 
or copy information from the window. 

The Trace window opens automatically when a trace is complete. 



Trace - Loading Data ( Frame: 1) 



state typ module Wit line 



function 



2 SEQ 
6 SEQ 
12 SEQ 
20 SEQ 
24 SEQ 
28 SEQ 
34 SEQ 
42 SEQ 
46 SEQ 
50 SEQ 
56 SEQ 
64 SEQ 
68 SEQ 
72 SEQ 



sampleWtt0038 
samp le\\ Jt0044 
sample Wtt0054 
sample\\tt0062 
sample W80038 
sample\\tt0044 
sample W80054 
sample Wtt0062 
sample Wtt0038 
sample Wtt0044 
sampleWtt0054 
sample Wtt0062 
sample Wtt0038 
sampleWtt0044 



convert < 
convert_case < 
change_statu < 
next_message < 
convert < 
conuert_case < 
change _statu < 
next_message < 
convert < 
conuert_case < 
change _statu < 
next_message < 
convert < 
conuert_case < 



1.200 uS^TG 



14.40 
232.4 
27.60 uS 
17.00 uS 
14.40 uS 
323.1 uS 
26.80 uS 
16.20 uS 
14.40 
254.0 



uS 
uS 



uS 
uS 



26.80 uS 



17. 



uS 



14.40 uS 



For each line in the Trace window, the trace buffer state number, the type of 
state, the module name and source file line number, the function name, the 
source line, and the time count information are displayed. 

The « and » buttons let you move between the multiple frames of trace 
data that are available with newer analyzers for the HP 64700. 

The type of state can be a sequence level branch (SEQ), a state that satisfies 
the prestore condition (PRE), or a normal state that matches the store 
conditions (in which case the type field is empty). 
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Bus cycle states show the address and data values that have been captured 
as well as the disassembled instruction or status mnemonics. 

On startup, the system defaults to the source only display mode, where only 
source code lines are displayed. The source/bus cycle mixed display mode 
can be selected by using the Trace window control menu's Display->Bus 
Cycle ON (ALT, -, D, B) command. In the source/bus cycle mixed display 
mode, each source code line is immediately followed by the corresponding 
bus cycles. 

The trace buffer stores bus cycles only. The system displays source lines in 
the Trace window based on execution bus cycles. 

See Also 

"Tracing Program Execution" and 

"Setting Up Custom Trace Specifications" in the "Debugging Programs" 
chapter. 

"Trace Window Commands" in the "Window Control Menu Commands" 
chapter. 



The UARTO Registers Window 



The UARTO Registers window displays contents of UARTO Registers. 



UART 0 Registers 



NAME UfiLUE DESCRIPTION 



U0TRMR 


=00 


UfiRTB 


U0BRG 


=00 


UART0 


U0TBR 


=0000 


UART0 


U0TRCR0 


=08 


UART0 


U0TRCR1 


=02 


UART0 


U0RBR 


=43FF 


UART0 



bit rate generator 



Tx/Rx Ctrl 1 



Each register is represented by a row which holds a mnemonic name, a 
current value, and a description of the register contents. 
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The registers may be edited by either single clicking or double-clicking on the 
value. A single click puts you in a mode where the left or right arrow keys 
may be used for placement of the cursor. Double-clicking puts you in one of 
two modes; either a Register Bit Fields dialog pops up or the value is 
highlighted. When the value is highlighted, the backspace key will erase the 
value and a completely new value may be entered. This mode is applicable to 
registers where the value is considered a single number and is not divided by 
any bit-fields. 

The UARTO Registers window's contents are updated periodically when the 
processor is running the user program and monitor intrusion is allowed. 

A temporary break from the user program into the monitor program must 
occur in order for the debugger to update or modify register contents. If it's 
important that the user program execute without these types of 
interruptions, you should disallow monitor intrusion. 

See Also 

Displaying and Editing Registers in the "Debugging Programs" chapter. 

Register Window Commands in the "Window Control Menu Commands" 
chapter. 

UARTO Registers 



Register 


Description 


Address 


Size 


Bit Edit 


uOtrmr 


UARTO Tx/Rx mode 


30H 


1 


0 


uObrg 


UARTO bit rate 


31H 


1 


0 




generator 








uOtbr 


UARTO Tx buffer 


32H 


2 




uOtrcrO 


UARTO Tx/Rx Ctrl 


0 34H 


1 


0 


uOtrcrl 


UARTO Tx/Rx Ctrl 


1 35H 


1 


0 


uOrbr 


UARTO Rx buffer 


36H 


2 
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The UART1 Registers Window 

The UART1 Registers window displays contents of UART1 Registers. 



NAME 



UART 1 Registers 



UALUE DESCRIPTION 



U1TRMR=00 
U1BRG=00 
U1TBR=0008 
U1TRCR0=08 
U1TRCR1=02 
U1RBR=03FF 



UART1 Tx/Rx node 
UART1 bit rate generator 
UART1 Tx buffer 
UART1 Tx/Rx Ctrl 0 
UART1 Tx/Rx Ctrl 1 
UART1 Rx buffer 




Each register is represented by a row which holds a mnemonic name, a 
current value, and a description of the register contents. 

The registers may be edited by either single clicking or double-clicking on the 
value. A single click puts you in a mode where the left or right arrow keys 
may be used for placement of the cursor. Double-clicking puts you in one of 
two modes; either a Register Bit Fields dialog pops up or the value is 
highlighted. When the value is highlighted, the backspace key will erase the 
value and a completely new value may be entered. This mode is applicable to 
registers where the value is considered a single number and is not divided by 
any bit-fields. 

The UART1 Registers window's contents are updated periodically when the 
processor is running the user program and monitor intrusion is allowed. 

A temporary break from the user program into the monitor program must 
occur in order for the debugger to update or modify register contents. If it's 
important that the user program execute without these types of 
interruptions, you should disallow monitor intrusion. 



See Also 

Displaying and Editing Registers in the "Debugging Programs" chapter. 

Register Window Commands in the "Window Control Menu Commands 1 
chapter. 
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UART1 Registers 



Register 


Description 


Address 


Size 


Bit 


ultrmr 


UART1 Tx/Rx mode 


38H 


1 


0 


ulbrg 


UART1 bit rate 


39H 


1 


0 




generator 








ultbr 


UART1 Tx buffer 


3AH 


2 




ultrcrO 


UART1 Tx/Rx Ctrl 


0 3CH 


1 


0 


ultrcrl 


UART1 Tx/Rx Ctrl 


1 3DH 


1 


0 


ulrbr 


UART1 Rx buffer 


3EH 


2 
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The Watchdog Timer Registers Window 

The Watchdog Timer Registers window displays contents of Watchdog Timer 
Registers. 



Each register is represented by a row which holds a mnemonic name, a 
current value, and a description of the register contents. 

The registers may be edited by either single clicking or double-clicking on the 
value. A single click puts you in a mode where the left or right arrow keys 
may be used for placement of the cursor. Double-clicking puts you in one of 
two modes; either a Register Bit Fields dialog pops up or the value is 
highlighted. When the value is highlighted, the backspace key will erase the 
value and a completely new value may be entered. This mode is applicable to 
registers where the value is considered a single number and is not divided by 
any bit-fields. 

The Watchdog Timer Registers window's contents are updated periodically 
when the processor is running the user program and monitor intrusion is 
allowed. 

A temporary break from the user program into the monitor program must 
occur in order for the debugger to update or modify register contents. If it's 
important that the user program execute without these types of 
interruptions, you should disallow monitor intrusion. 

See Also 

Displaying and Editing Registers in the "Debugging Programs" chapter. 

Register Window Commands in the "Window Control Menu Commands" 
chapter. 





NAME 



UfiLUE DESCRIPTION 



WDT=00 
UDTFSF=00 



Watchdog tinier 
Frequency selection 
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Watchdog Timer Registers 

Register Description Address Size Bit Edit Note 

wdt Watchdog Timer 60H 1 

wdtfsf Frequency selection 61H 1 0 



The WatchPoint Window 

The WatchPoint window displays the contents of variables that have been 
registered with the Variable— >Edit... (ALT, V, E) command or with the Edit... 
(ALT, -, E) command in the WatchPoint window's control menu. 




The contents of dynamic variables are displayed only when the current 
program counter is in the function in which the variable is declared. 

You can modify the contents of variables by double-clicking on the value, 
using the keyboard to type in the new value, and pressing the Return key. 

The WatchPoint window lets you copy text strings, to the clipboard by 
double-clicking words or by holding down the left mouse button and dragging 
the mouse pointer. 

See Also 

"Displaying and Editing Variables" in the "Debugging Programs" chapter. 

"WatchPoint Window Commands" in the "Window Control Menu Commands" 
chapter. 
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Compiler/Assembler Specifications 

This section describes: 

• IEEE-695 Object Files 

• Compiling Programs with ICC7700 



IEEE-695 Object Files 

This section addresses the IEEE-695 object files generated by following 
IEEE-695 converter after compiled or assembled with the following compiler 
and assembler: 

• IAR ICC7700 Compiler 

• IAR A7700 Assembler 

• MRI MCCM77 Compiler 

• MRI ASMM77 Assembler 

• Mitsubishi NC77 Compiler 

• Mitsubishi RASM77 Assembler 



Assembly Language Source File Display 

The IEEE-695 object files do not contain assembly language source file 
information. Instead, memory contents are disassembled. 



Mnemonic Display 

An assembly language instruction preceding or following a function entry 
point may have multiple corresponding source code lines. For this type of 
instruction, the Source window in the Mnemonic Display mode shows 
multiple corresponding disassembled lines having the same address. 
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Single-Stepping Loop Control Statements 

The system may fail in single-stepping such loop control statements as 
"while", "for", or "do while" statement. 



Compiling Programs with ICC7700 

1 Compile the source files with the icc7700 command. 

2 Assemble the source files with the a7700 command. 

3 Link the object files with the xlink command. 

4 Convert UBROF file to IEEE-695 file with iar2ieee command. 

Required Compiler/Assembler/Linker/Converter 

Compiler 

IAR ICC7700 Compiler/DOS 
Assembler 

IAR A7700 Assembler/DOS 

Linker 

IAR XLINK Linker/DOS 
Converter 

IAR UBROF to IEEE-695 Converter 

Compiling 

For compiling, use the icc7700 command in your IAR C Compiler with the 
following option switches: 

-r Generates debug information. 

-zO Optimize for size. 

-P Generates PROMable code. 
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Note You need to use -e and -2 options when you use double float. 



Note You can't use -ri, -rn, and -s options to compile. 



Assembling 

For assembling, use the a7700 command in your IAR Assembler with the 
following option switch: 

-r Enables debugger output. 



Note Since UBROF format file does not include assembler local symbol 

information, you can not debug assembler module using IEEE-695 file 
converted from UBROF file. If you need to debug assembler module, you 
must specify assembler local symbols by using PUBLIC directive. 



Linking 

For linking, use the xlink command in your IAR Linker with either of the 
following option switches: 

-r Link with debug. 

-FDEBUG Link with debug. 

Converting 

For converting to IEEE-695 format from UBROF format, use the iar2ieee 
command in your IAR converter. 

See Also 

"To select memory model" in the "Configuring the Emulator" chapter. 
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Compiling Programs with MCCM77 


1 


Compile the source files with the mccm77 command. 


2 


Assemble the source files with the asmm77 command. 


3 


Link the object files with the lnkm77 command. 




Required Compiler/ Assembler/Linker/Converter 




Compiler 




MRI MCCM77 Compiler/DOS 




Assembler 




MRI ASMM77 Assembler/DOS 




Compiling 




For compiling, use the mccm77 command in your MRI C Compiler with the 




following option switches: 




-g Generates debug information. 




-c Generates object file. 




-nOg Turn off Global-Flow optimizer. 








For assembling, use the asmm77 command in your MRI Assembler with the 




following option switch: 




-f d Places debug information into object file. 




Linking 




For linking, use the lnkm77 command in your MRI Linker. 




See Also 




"To select memory model" in the "Configuring the Emulator" chapter. 
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Compiling Programs with NC77 

1 Compile the source files with the nc77 command. 

2 Assemble the source files with the rasm77 command. 

3 Link the object files with the link77 command. 

4 Convert MELPS 7700 Hex file to IEEE-695 file with s2ie command. 

Required Compiler/Assembler/Linker/Converter 

Compiler 

Mitsubishi NC77 Compiler/DOS 
Assembler 

Mitsubishi RASM77 Assembler/DOS 

Linker 

Mitsubishi LINK77 Linker/DOS 
Converter 

Mitsubishi s2ie Converter/DOS 

Compiling 

For compiling, use the nc77 command in your Mitsubishi C Compiler with the 
following option switches: 

-gie Generates IEEE-695 format file, 

-c Generates object file. 

Assembling 

For assembling, use the rasm77 command in your Mitsubishi Assembler with 
the following option switch: 

-s Generates local symbol information, 

-c Generates source debug information. 
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Linking 

For linking, use the link77 command in your Mitsubishi Linker with the 
following option switch: 

-s Generates local symbol information. 

Converting 

For converting to IEEE-695 format from MELPS Hex format, use the s2ie 
command. 

See Also 

"To select memory model" in the "Configuring the Emulator" chapter. 
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Monitor Programs 

This section describes: 

• Monitor Program Options 

• Assembling, Linking and Converting the Foreground Monitor 

• Notes on Foreground Monitors 

The foreground monitor source file is included with the debugger software 
and can be found in the C:\HP\RTC\M7700\FGMON directory (if 
C:\HP\RTC\M7700 was the installation path chosen when installing the 
debugger software). 



Monitor Program Options 

The emulation monitor program is a program that the emulation 
microprocessor executes as directed by the HP 64700 system controller. The 
emulation monitor program gives the system controller access to the target 
system. 

For example, when you modify target system memory, the system controller 
writes a command code to a communications area and switches, or breaks, 
emulation processor execution into the monitor program. The monitor 
program reads the command code (and any associated parameters) from the 
communications area and executes the appropriate machine instructions to 
modify the target system locations. After the monitor has performed its task, 
emulation processor execution returns to what it was doing before the break. 

The emulation monitor program can execute out of a separate, internal 
memory system known as background memory. A monitor program 
executing out of background memory is known as a background monitor 
program. 

The emulation monitor program can also execute out of the same memory 
system as user programs. This memory system is known as foreground 
memory and consists of emulation memory and target system memory. A 
monitor program executing out of foreground memory is known as a 
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foreground monitor program. Foreground monitor programs must exist in 
emulation memory. 

The emulator firmware includes the background monitor. You can also load 
and use a foreground monitor program if needed. 

Background Monitor 

The default emulator configuration selects the background monitor. 

Usually, the background monitor will be easier to work with in starting a new 
design. So it is recommended to use background monitor. The background 
monitor is immediately available and upon powerup, and you don't worry 
about linking in the code or allocating space for the monitor to use the 
emulator. 

Interrupts from the target system are disabled during background monitor 
execution. If your programs have strict real-time requirements for servicing 
target system interrupts, you must use a foreground monitor program. 

Foreground Monitor 

A foreground monitor source files are provided with the debugger software. It 
can be assembled, linked, and loaded into the debugger. 

A foreground monitor has the following advantages and disadvantages: 

Advantages 

• The foreground monitor executes as a part of the user program, and 
target system interrupts can be enabled during monitor program 
execution for applications that have strict real-time processing 
requirements. 

• The foreground monitor can be customized. 
Disadvantages 

• You can not perform run control commands from menu bar commands, 
and need to create buttons to use their functions. Refer to the Notes on 
Foreground Monitors to create buttons. 

• Step command in not available when the emulator is used with a 
foreground monitor. 

• The foreground monitor occupies 2 Kbytes of the user memory space. 
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• The foreground monitor must be assembled and linked prior to use. 

• You cannot perform synchronized measurements over the CMB. 

Addressing for Foreground Monitor 

The foreground monitor is loaded into emulation memory just like a user 
program. Assemble and link the foreground monitor at an address space not 
used by the user program. 

In the HP 64146/7 emulator, the starting address can be specified on a 2 
Kbyte boundary in bank 0 other then Internal RAM area and SFR area. 

To specify the foreground monitor starting address, you must modify the 
.EQU statement that follows the first comment in the source program as 
shown below. 

LOCATE_ADRS . EQU OxxxxH ; start monitor on 2 k byte 

; boundary in bank 0 
; rather than sfr/iram area 

PROCMODEREG .EQU OxxxxH ; processor mode 

; register's address 



Specify the foreground monitor address and processor mode register address 
by modifying OxxxxH. 

Specifying Processor Name 

To use foreground monitor with 7751 microprocessor, you need to modify 
the processor name section of foreground monitor source. Default setting is 
following. 

CHIP 7 751 .WORD 0 ; OTHER_THAN_7 7 51 

You can specify 7751 microprocessor by modifying this section like below. 
CHIP 7 751 .WORD 1 ; 7 751 
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Processor Mode Register Address 

You may need to modify the .EQU statement at the PROCMODEREG label. 
This value defines the location of processor mode register. If your processor 
has processor mode register at address other than 5e hex, modify this value 
to appropriate value. 
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Assembling, Linking the Foreground Monitor with 
A7700 

The foreground monitor can be assembled, linked with your Assembler and 
Linker. 

If you want to assemble the foreground monitor with IAR A7700 assembler, 
enter: 

C> a7700 -r fgmon.s28 

To link the foreground monitor, enter: 

C> xlink -r -c7700 -o fgmon.d28 fgmon.s28 

To convert the foreground monitor, enter: 
C> iar2ieee fgmon.d28 fgmon.x 



Notes on Foreground Monitors 

User Program Out of Control 

A user program that runs out of control may damage the foreground monitor 
residing in the user memory space; if this happens, you must reload the 
foreground monitor. An Execution— >Reset (ALT, E, E) command will 
automatically reload the foreground monitor. 

To use the HP 64146/7 emulator with the foreground monitor 

When using the foreground monitor, you cannot use the run control 
commands from the menu bar. To run the user program, you need to create 
user-defined buttons and execute them instead of using the run control 
commands. The following user-defined buttons executes the user program 
from the terminal mode of the emulator. 

Button Name Button Command Operation 

TERM RUN termcom r Run from current PC 
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If you want to execute "run from address", you need to modify Program 
counter to the address you want to start. 

And also, if you want to do step exection, you need to set a breakpoint at 
address you want to stop. 

To run from breakpoint address using the above-mentioned button (TERM 
RUN), you need to delete a breakpoint. Therefore, we recommend to create a 
following user-defined button that deletes all of breakpoints. 

Button Name Button Command Operation 

DEL BP bp delete all Delete all breakpoints 
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Trace Signals and Predefined Status Values 

This section describes how emulation analyzer trace signals are assigned to 
microprocessor address bus, data bus, and control signals. 



Emulation Analyzer Trace Signals 



Trace 

Signals Signal 



0-15 

16-39 

40 

41 
42 

43 

44-45 
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D0-D15 

A0-A2 3 

R/W_L 

UDEN_L 
DATA_L 

EXEC_L 

MASTER0-1 



BKG 



Name Signal Description 

Processor Data 0-15 

Address Lines 0-23 

0 = Write Cycle, 1 = Read Cycle 

0 = User Data Enable 
0 = Data Cycle 

0 = Execution Cycle 

00 = Refresh Cycle 

01 = Hold Cycle 

10 = DMA Cycle 

11 = CPU Cycle 

0 = Foreground Cycle, 

1 = Background Cycle 
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MX 



1 = MX Cycle 
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Predefined Status Values 



Qualifier 


Status 


Bits (47-40) 


Description 


bg 


Oxlxx 


xxxxy 


Background cycle 


byte 


Oxxlx 


lxlxy 


Byte access cycle 


cpu 


Oxxll 


xxxxy 


CPU cycle 


data 


Oxxlx 


lOxxy 


Data access cycle 


dataread 


Oxxlx 


lOxly 


Data read cycle 


datawrite 


Oxxlx 


lOxOy 


Data access cycle 


dma 


OxxlO 


xxxxy 


DMA cycle 


dmaread 


OxxlO 


lxxly 


DMA read cycle 


dmawrite 


OxxlO 


lxxOy 


DMA write cycle 


exec 


Oxxll 


Olxxy 


Execution cycle 


fetch 


Oxxll 


llxly 


Fetch cycle 


fg 


OxOxx 


xxxxy 


Foreground cycle 


hold 


OxxOl 


xxxxy 


Hold cycle 


mx 


0 lxxx 


xxxxy 


MX cycle 


read 


Oxxlx 


lxxly 


Read cycle 


ref 


OxxOO 


xxxxy 


Refresh cycle 


word 


Oxxlx 


lxOxy 


Word access cycle 


write 


Oxxlx 


lxxOy 


Write cycle 
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Installation Guide 

Instructions for installing the product. 
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This chapter shows you how to install the Real-Time C Debugger. 

• Requirements 

• Before Installing the Debugger 

• Step 1 . Connect the HP 64700 to the PC 

• Step 2. Install the debugger software 

• Step 3. Start the debugger 

• Step 4. Check the HP 64700 system firmware version 

• Optimizing PC Performance for the Debugger 
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Requirements 

• IBM compatible or NEC PC with an 80386 microprocessor and 4 
megabytes of memory. 

• MS Windows 3.1. 

• VGA Display. 

• 3 Megabytes available disk space. 

• Serial port, HP 64037 RS-422 port, or Novell LAN with Lan Workplace for 
DOS or Microsoft Lan Manager with HP ARPA Services. 

• Revision A.04. 00 or greater of HP 64700 system firmware. The last step 
in this chapter shows you how to check the firmware version number. 

As with many Windows applications, 8 megabytes or more of memory and an 
80486 microprocessor will measurably improve performance. 
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Before Installing the Debugger 

• Install MS Windows according to its installation manual. The Real-Time 
C Debugger must run under MS Windows in the 386 enhanced mode. 

• If the HP 64700 is to communicate with the PC via LAN: 

Make sure the HP 64700 LAN interface is installed (see the "HP 64700 Series 
Installation/Service" manual) . 

Install the LAN card into the PC, and install the required PC networking 
software. 

Obtain the Internet Address, the Gateway Address, and the Subnet Mask to 
be used for the HP 64700 from your Network Administrator. These three 
addresses are entered in integer dot notation (for example, 192.35.12.6). 

• If the HP 64700 is to communicate with the PC via RS-422: 

Install the HP 64037 RS-422 interface card into the PC. The Real-Time C 
Debugger includes software that configures the RS-422 interface. 
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Step 1. Connect the HP 64700 to the PC 

You can connect the HP 64700 to an RS-232 serial port on the PC, the Local 
Area Network that the PC is on, or an HP 64037 RS-422 interface that has 
been installed in the PC. 

• To connect via RS-232 

• To connect via LAN 

• To connect via RS-422 



To connect via RS-232 

1 Set the HP 64700 configuration switches for RS-232C communication. 
Locate the DIP switches on the HP 64700 rear panel, and set them as 
shown below. 




Notice that switches 1 through 3 are set to 001, respectively. This sets the 
baud rate to 19200. 

Notice also that switches 12 and 13 are set to 1 and 0, respectively. This sets 
the RTS/CTS hardware handshake which is needed to make sure all 
characters are processed. 
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2 Connect an RS-232C modem cable from the PC to the HP 64700 (for 
example, an HP 24542M 9-pin to 25-pin cable or an HP 13242N 25-pin 
to 25-pin cable). 

If you want to build your own RS-232 cable, follow one of the pin-outs for HP 
cables shown in the following figure. 



13242N R5-232-C 25-25 pin 



24542M R5-232-C 9-25 pin 



CPU 
25-pin M 

Chassis GND 
TD 
RD 
RT5 
CT5 
D5R 
Signal GND 



HP 64700 
25-pin M 



1 

2 
3 
4 
5 
6 
7 




1 








2 
3 
4 
5 
6 
7 






































8 
11 
12 
15 
17 
19 
20 
22 
23 
24 








8 
19 
12 
15 
17 
































11 

20 
22 
23 
24 























CPU 



9-pin M 


□ CD 


1 - 


RD 


2 - 


TD 


3 - 


DTR 


4 - 


Signal GND 


5 - 


DSR 


6 - 


RT5 


7 - 


CTS 


6 - 




9 - 



HP 64700 
25-pin M 



-J3_ 
-_2 
-20 

- 7 
-_6 

- 4 
-_5 
-22 



DCD = Data Carrier Detect 

RD = Receive Data 

TD Transmit Data 

DTR = Data Terminal Ready 

GND = Ground 

DSR = Data Set Ready 

RTS = Request to Send 

CTS = Clear ta Send 



h/;;::-:' 



You can also use an RS-232C printer cable, but you must set HP 64700 
configuration switch 4 to 1 . 

3 Turn ON power to the HP 64700. 

The power switch is located on the lower left-hand corner of the front panel. 
The power light at the lower right-hand corner of the front panel will be 
illuminated. 
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4 Start MS Windows in the 386 enhanced mode. 

5 Verify RS-232 communication by using the Terminal program that is 
found in the Windows "Accessories" group box. 

Double-click on the 'Terminal" icon to open the Terminal window. Then, 
choose the Settings— ^Communications... (ALT, S, C) command, and select: 
19200 Baud Rate, 8 Data Bits, 1 Stop Bit, Parity None, Xon/Xoff Flow 
Control, and the PC's RS-232 interface connector. Choose the OK button. 

You should now be able to press the Return key in the Terminal window to 
see the HP 64700's Terminal Interface prompt (for example, "R>", "M>", "U>", 
etc.). If you see the prompt, you have verified RS-232 communication. If you 
do not see the prompt, refer to "If you cannot verify RS-232 communication". 

If you will be using the RS-232 connection for the debugger, exit the 
Terminal program and go to Step 2. Install the debugger software. 

If you will be using the LAN connection, go to To connect via LAN. 
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To connect via LAN 
1 Set the HP 64700 LAN parameters. 

If you're setting the HP 64700 LAN parameters for the first time, you must 
connect the HP 64700 to the PC via RS-232 before you can access the HP 
64700 Terminal Interface. Follow the steps in To connect via RS-232 and 
then return here. 

If you're changing the LAN parameters of a HP 64700 that is already on the 
LAN, you can use the "telnet <HP 64700 IP address>" command to access the 
HP 64700 Terminal Interface. 

Once the HP 64700 Terminal Interface has been accessed, display the 
current LAN parameters by entering the "lan" command: 

R>lan 

lan -i 15.6.25.117 
lan -g 15.6.24.1 
lan -s 255.255.248.0 

lan -p 6470 

Ethernet Address : 08000909BBC1 

The "lan -i" line shows the Internet Address (or IP address). The Internet 
Address must be obtained from your Network Administrator. The value is 
entered in integer dot notation. For example, 192.35.12.6 is an Internet 
Address. You can change the Internet Address with the "lan -i <new IP>" 
command. 

The "lan -g" line shows the Gateway Address which is also an Internet 
address and is entered in integer dot notation. This entry is optional and will 
default to 0.0.0.0, meaning all connections are to be made on the local 
network or subnet. If connections are to be made to workstations on other 
networks or subnets, this address must be set to the address of the gateway 
machine. The gateway address must be obtained from your Network 
Administrator. You can change the Gateway Address with the "lan -g <new 
gateway address>" command. 

The "lan -s" line may or may not be shown, depending on the HP 64700 
model. If this line is not shown, the Subnet Mask is automatically configured. 
If this line is shown, it shows the Subnet Mask in integer dot notation. This 
entry is optional and will default to 0.0.0.0. The default is valid only on 
networks that are not subnetted. (A network is subnetted if the host portion 
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of the Internet address is further partitioned into a subnet portion and a host 
portion.) If the network is subnetted, a subnet mask is required in order for 
the emulator to work correctly. The subnet mask should be set to all "l"s in 
the bits that correspond to the network and subnet portions of the Internet 
address and all "0"s for the host portion. The subnet mask must be obtained 
from your Network Administrator. You can change the Subnet Mask with the 
"lan -s <new subnet mask>" command. 

Both the PC's subnet mask and the emulator's subnet mask must be identical 
unless they communicate via a gateway or a bridge. Unless your Network 
Administrator states otherwise, make them the same. You can check the 
PC's subnet mask with the "lminst" command if you are using HP-ARPA. If 
you are using Novell LAN Workplace, make sure the file \NET.CFG has the 
entry "ip_netmask <subnet mask>" in the section "Protocol TCPIP". 

The "lan -p" lines shows the base TCP service port number. The host 
computer interfaces communicate with the HP 64700 through two TCP 
service ports. The default base port number is 6470. The second port has 
the next higher number (default 6471). If the service port is not 6470, you 
must change it with the "lan -p 6470" command. 

The Internet Address and any other LAN parameters you change are stored 
in nonvolatile memory and will take effect the next time the HP 64700 is 
powered off and back on again. 

2 Exit the Terminal or telnet program. 

3 Turn OFF power to the HP 64700. 

4 Connect the HP 64700 to the LAN. This connection can be made 
using either the 15-pin AUI connector or the BNC connector. 

DO NOT use both connectors. The LAN interface will not work with both 
connected at the same time. 
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5 Set the HP 64700 configuration switches for LAN communication. 




Switch 16 must be set to one (1) indicating that a LAN connection is being 
made. 

Switch 15 should be zero (0) if you are connecting to the BNC connector or 
set to one (1) if a 15 pin AUI connection is made. 

Switch 14 should be zero (0). 

Set all other switches to zero (0). 
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6 Turn ON power to HP 64700. 

7 Verify LAN communication by using a "telnet <HP 64700 IP address>" 
command. This connection will give you access to the HP 64700 
Terminal Interface. 

You should now be able to press the Return key in the telnet window to see 
the HP 64700's Terminal Interface prompt (for example, "R>", "M>", "U>", 
etc.). If you see the prompt, you have verified LAN communication. If you 
cannot connect to the HP 64700's IP address, refer to "If you cannot verify 
LAN communication". 
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To connect via RS-422 

Before you can connect the HP 64700 to the PC via RS-422, the HP 64037 
RS-422 Interface must have already been installed into the PC. 

1 Set the HP 64700 configuration switches for RS422 communication. 
Locate the DIP switches on the HP 64700 rear panel, and set them as 
shown below. 



Notice that switches 1 through 3 are set to 111, respectively. This sets the 
baud rate to 230400. 

Notice that switch 5 is set to 1 . This configures the 25-pin port for RS-422 
communication. 

Notice also that switches 12 and 13 are set to 1 and 0, respectively. This sets 
the RTS/CTS hardware handshake which is needed to make sure all 
characters are processed. 

2 Connect the 17355M cable (which comes with the HP 64037 
interface) from the PC to the HP 64700. 

3 Turn ON power to the HP 64700. 

The power switch is located on the lower left-hand corner of the front panel. 
The power light at the lower right-hand corner of the front panel will be 
illuminated. 
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If you cannot verify RS-232 communication 

If the HP 64700 Terminal Interface prompt does not appear in the Terminal 
window: 

D Make sure that you have connected the emulator to the proper power source 
and that the power light is lit. 

□ Make sure that you have properly configured the data communications 
switches on the emulator and the data communications parameters on your 
controlling device. You should also verify that you are using the correct 
cable. 

The most common type of data communications configuration problem 
involves the configuration of the HP 64700 as a DCE or DTE device and the 
selection of the RS-232 cable. If you are using the wrong type of cable for the 
device selected, no prompt will be displayed. 

When the RS-232 port is configured as a DCE device (S4 is set to 0), a 
modem cable should be used to connect the HP 64700 to the host computer 
of terminal. Pins 2 and 3 at one end of a modem cable are tied to pins 2 and 3 
at the other end of the cable. 

When the RS-232 port is configured as a DTE device (S4 is set to 1) , a printer 
cable should be used to connect the HP 64700 to the host computer of 
terminal. Pins 2 and 3 at one end of a printer cable are swapped and tied to 
pins 3 and 2, respectively, at the other end of the cable. 

If you suspect that you may have the wrong type of cable, try changing the S4 
setting and turning power to the HP 64700 OFF and then ON again. 
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If you cannot verify LAN communication 

Use the "telnet" command on the host computer to verify LAN 
communication. After powering up the HP 64700, it takes a minute before 
the HP 64700 can be recognized on the network. After a minute, try the 
"telnet <internet address>" command. 

If "telnet" does not make the connection: 

□ Make sure that you have connected the emulator to the proper power source 
and that the power light is lit. 

□ Make sure that the LAN cable is connected. Refer to your LAN 
documentation for testing connectivity. 

□ Make sure the HP 64700 rear panel communication configuration switches 
are set correctly. Switch settings are only used to set communication 
parameters in the HP 64700 when power is turned OFF and then ON. 

□ Make sure that the HP 64700's Internet Address is set up correctly. You 
must use the RS-232 port to verify this that the Internet Address is set up 
correctly. While accessing the emulator via the RS-232 port, run 
performance verification on the HP 64700's LAN interface with the "lanpv" 
command. 

If "telnet" makes the connection, but no Terminal Interface prompt (for 
example, R>, M>, U>, etc.) is supplied: 

D It's possible that the HP 64000 software is in the process of running a 

command (for example, if a repetitive command was initiated from telnet in 
another window). You can use CTRL+c to interrupt the repetitive command 
and get the Terminal Interface prompt. 

CH It's also possible for there to be a problem with the HP 64700 firmware while 
the LAN interface is still up and running. In this case, you must turn OFF 
power to the HP 64700 and turn it ON again. 
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Step 2. Install the debugger software 

1 If you are updating or re-installing the debugger software, you may 
want to save your B3630.INI file because it will be overwritten by the 
installation process. 

2 Start MS Windows in the 386 enhanced mode. 

3 Insert the Real-Time C Debugger system disk into floppy disk drive A 
or B. 

4 Choose the File— >Run... (ALT, F, R) command in the Windows 
Program Manager. Enter "a:\setup" (or "b:\setup" if you installed the 
floppy disk into drive B) in the Command Line text box. 





Run 




aAsetupj Cancel 1 


□ Run Minimized 


Browse... | 
Help j 



Then, choose the OK button. Follow the instructions on the screen. 
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You will be asked to enter the installation path. The default installation path 
is C:\HP\RTC\M7700. The default installation path is shown wherever files 
are discussed in this manual. 



Installation Path for HP Real-Time C 



The setup piogram will copy the HP 
Real-Time C pioduct into the following 
directory 



Path: 



C:\HP\RTC\M7700 



The piogram group "HP Real-Time C Debugger" will 
be added to the Program Manager. Items for the 
Debugger and Help files will be created. Additions 
to the Extensions section of the system file 
"WIN.INI" will be made. 



Continue 



Exit 



Help 



You will be asked to enter your user ID. This information is important if the 
HP 64700 is on the LAN and may be accessed by other users. It tells other 
users who is currently using, or who has locked, the HP 64700. This 
information can be modified while using the Real-Time C Debugger by 
choosing the Settings— ^Communication... (ALT, S, C) command. 



User Identification 



It is important that you fill in the following information. Failure to do so 
will result in the emulator locking feature not functioning properly. 



UserName should be your name, initials, or login. The 
is 25 characters. 



length 



UserName: 



Chris Smith 



The UserlD should be a unique identification number. For example, 
your phone extension or your userid number. The maximum length is 8 
digits. 

UsedD: 5678 



Continue i 




Back 




Exit 




Help I 
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You will be asked to select the type of connection to be made to the HP 
64700. This information can be modified while using the Real-Time C 
Debugger by choosing the Settings— ^Communication... (ALT, S, C) command. 



Real-Time C Emulation Connection 



Select the communication channel to be used between the 
personal computer and the emulator. 



Xransport: 



H P AR PA 



Enter the connection name. An example for RS232C would be 
COM1. For HP-ARPA . use the emulator Ian IP address or the 
emulator's network name. For HP-RS422, use the address of 
the HP64037 card. 



Connection: 



15.G.25.24| 



Back 



Exit 



] I H* I 



After you have specified the type of connection, files will be copied to your 
hard disk. (The B3630.TMP and B3630.HLP files are larger than most of the 
other files and take longer to copy.) Fill out your registration information 
while waiting for the files to be copied. 

If the Setup program detects that one or more of the files it needs to install 
are currently in use by Windows, a dialog box informs you that Windows 
must be restarted. You can either choose to restart Windows or not. If you 
don't choose to restart Windows, you can either run the _MSSETUP.BAT 
batch file (in the same directory that the debugger software is installed in) 
after you have exited Windows or re-install the debugger software later when 
you are able to restart Windows. 
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Step 3. Start the debugger 

1 If the "HP Real-Time C Debugger" group box is not opened, open it by 
double-clicking in the icon. 

2 Double-click the "M7700 Real-Time C Debugger" icon. 

If you have problems connecting to the HP 64700, refer to: 

• If you have RS-232 connection problems 

• If you have LAN connection problems 

• If you have RS-422 connection problems 



If you have RS-232 connection problems 

CH Remember that Windows 3.1 only allows two active RS-232 connections at a 
time. To be warned when you violate this restriction, choose Always Warn 
in the Device Contention group box under 386 Enhanced in the Control 
Panel. 

CH Use the "Terminal" program (usually found in the Accessories windows 
program group) and set up the "Communications..." settings as follows: 

Baud Rate: 19200 (or whatever you have chosen for the 

emulator) 

Data Bits: 8 

Parity: None 

Flow Control: Xon/Xoff 

Stop Bits: 1 

When you are connected, hit the Enter key. You should get a prompt back. 
If nothing echos back, check the switch settings on the back of the emulator: 
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Switches 1 thru 3 set the baud rate as follows: 



SI 


S2 


S3 




0 


0 


0 


9600 


0 


0 


1 


19200 


0 


1 


0 


2400 



Switches 12 and 13 must be set to 1 and 0, respectively. This sets the 
RTS/CTS hardware handshake which is needed to make sure all characters 
are processed. 

All other switches should be in the "0" position, especially the switch that 
determines LAN/Serial interface (switch 16 on HP 64700). 

Remember that if you change any of the switch positions you must turn OFF 
power to the HP 64700 and turn it ON again before the changes will take 
effect. 

CH If the switches are in the correct position and you still do not get a prompt 
when you hit return, try turning OFF the power to the HP 64700 and tuning it 
ON again. 

D If you still don't get a prompt, make sure the RS-232 cable is connected to 
the correct port on your PC, and that the cable is appropriate for connecting 
the PC to a DCE device. If the cable is intended to connect the PC to a DTE 
device, set switch 4 to "1" (which makes the emulator a DTE device), turn 
OFF power to the HP 64700, turn power ON, and try again. 

With certain RS-232 cards, connecting to an RS-232 port where the HP 64700 
is turned OFF (or is not connected) will hang the PC. The only way to get 
control back is to reboot the PC. Therefore, we recommend that you always 
turn ON the HP 64700 before attempting to connect via RS-232. 
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If you have LAN connection problems 

□ Try to "ping" the emulator: 

ping <hostname or IP address> 
If the emulator does not respond: 

1. Check that switch 16 on the emulator is "1" (emulator is attached to LAN, 
not RS-232 or RS-422). 

2. Check that switch 15 on the emulator is in the correct position for your 
LAN interface (either the AUI or the BNC). 

(Remember: if you change any switch settings on the emulator, the changes 
do not take effect until you power cycle the emulator.) 

□ If the emulator still does not respond to a "ping", you need to verify the IP 
address and subnet mask of the HP 64700. To do this, connect the HP 64700 
to a terminal (or to the Terminal application on the PC), change the 
emulator's switch settings so it is connected to RS-232, and enter the "lan" 
command. The output looks something like this: 

lan -i 15.6.25.117 
lan -g 15.6.24.1 
lan -s 255.255.248.0 

lan -p 6470 

Ethernet Address : 08000909BBC1 

The important outputs (as far as connecting) are: 

"lan -i"; this shows the internet address is 15.6.25.117 in this case. If the 
Internet address (IP) is not what you expect, you can change it with the 'lan 
-i <new IP>' command. 

"lan -s"; shows the subnet mask is 255.255.248 (the upper 21 bits -- 
255.255.248.0 == FF.FF.F8.0). If the subnet mask is not what you expect, 
you can change it with the lan -s <new subnet mask>' command. 

"lan -p"; shows the port is 6470. If the subnet port is not 6470, you must 
change it with the "lan -p 6470" command. 

Both the PC's subnet mask and the emulator's subnet mask must be identical 
unless they communicate via a gateway or a bridge. Unless your Network 
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Administrator states otherwise, make them the same. You can check the 
PC's subnet mask with the "lminst" command if you are using HP-ARPA. If 
you are using Novell LAN Workplace, make sure the file \NET.CFG has the 
entry "ip_netmask <subnet mask>" in the section "Protocol TCPIP". 

D Occasionally the emulator or the PC will "lock up" the LAN due to excessive 
network traffic. If this happens, all you can do is turn OFF power to the HP 
64700 or PC, turn power back ON, and hope it doesn't happen again. Also, 
you could place a gateway between the emulator/PC and the rest of your 
network. 
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If you have RS-422 connection problems 

□ Make sure the HP 64700 switch settings match the baud rate chosen when 
attempting the connection. 

Switches 1 thru 3 set the baud rate as follows: 



SI 


S2 


S3 




1 


1 


1 


230400 


1 


1 


0 


115200 


1 


0 


1 


38400 


1 


0 


0 


57600 


0 


1 


1 


1200 


0 


1 


0 


2400 


0 


0 


1 


19200 


0 


0 


0 


9600 



Switch 5 must be set to 1 to configure the HP 64700 for RS-422 
communication. 

Switches 12 and 13 must be set to 1 and 0, respectively. This sets the 
RTS/CTS hardware handshake which is needed to make sure all characters 
are processed. 

All other switches should be in the "0" position, especially the switch that 
determines LAN/Serial interface (switch 16 on HP 64700). 

Remember that if you change any of the switch positions you must turn OFF 
power to the HP 64700 and turn it ON again before the changes will take 
effect. 

□ If the switches are in the correct position and you still do not get a prompt 
when you hit return, try turning OFF the power to the HP 64700 and tuning it 
ON again. 

□ If you still don't get a prompt, make sure the HP 17355M RS^22 cable is 
connected to the correct port on your PC. 
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Step 4. Check the HP 64700 system firmware 
version 

• Choose the Help— >About Debugger/Emulator... (ALT, H, D) command. 

The version information under HP 64700 Series Emulation System must show 
A. 04. 00 or greater. If the version number is less than A.04.00, you must 
update your HP 64700 system firmware as described in the 
Installing/Updating HP 64700 Firmware chapter. 
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Optimizing PC Performance for the Debugger 

The Real-Time C Debugger is a memory and I/O intensive Windows program. 
Slow user interface performance may be caused by many things: 

• Underpowered PC - The Real-Time C Debugger requires an IBM 
compatible or NEC PC with an 80386 microprocessor and 4 megabytes of 
memory. Acceptable performance is usually found on 25 Mhz 386DX 
systems and faster. 386SX and slower speed systems will probably feel 
quite sluggish. 

• Improperly configured PC — Windows configuration may have a very 
significant effect on performance. The Windows swap file settings are 
very important (see the Virtual Memory dialog box under 386 Enhanced 
in the Control Panel). The larger the swap file, the better the 
performance. Permanent swap has superior performance. 

• Disk performance (due to Windows swap file access and Windows dialog 
and string resource accesses from the debugger ".EXE" file) - The disk 
speed has a direct impact on performance of the Real-Time C Debugger. 
Use of SMARTDrive or other RAM disk or caching software will improve 
the performance. 

Various PC performance measurement and tuning tools are commercially 
available. Optimizing your PC performance will improve debugger interface 
performance and, of course, all your other PC applications will benefit as well. 
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Installing/Updating HP 64700 Firmware 



This chapter shows you how to install or update HP 64700 firmware. 

N Ote Your HP 64700 must contain Flash EPROM memory before you can install or 

update HP 64700 system firmware. 

The firmware, and the program that downloads it into the HP 64700, are 
included with the debugger on floppy disks labeled HP 64700 EMULATION 
AND ANALYSIS FIRMWARE. 

The steps to install or update HP 64700 firmware are: 

• Step 1 . Connect the HP 64700 to the PC 

• Step 2. Install the firmware update utility 

• Step 3. Run PROGFLASH to update HP 64700 firmware 
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Step 1. Connect the HP 64700 to the PC 

1 Set the HP 64700 configuration switches for RS-232C communication. 
Locate the DIP switches on the HP 64700 rear panel, and set them as 
shown below. 




Notice that switches 12 and 13 are set to 1 and 0, respectively. This sets the 
RTS/CTS hardware handshake which is needed to make sure all characters 
are processed. 

2 Connect an RS-232C modem cable from the PC to the HP 64700 (for 
example, an HP 24542M 9-pin to 25-pin cable or an HP 13242N 25-pin 
to 25-pin cable). 

You can also use an RS-232C printer cable, but you MUST set HP 64700 
configuration switch 4 to 1 . 

3 Turn ON power to the HP 64700. 

The power switch is located on the lower left-hand corner of the front panel. 
The power light at the lower right-hand corner of the front panel will be 
illuminated. 
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4 Start MS Windows in the 386 enhanced mode. 

5 Verify RS-232 communication by using the Terminal program that is 
found in the Windows "Accessories" group box. 

Double-click on the "Terminal" icon to open the Terminal window. Then, 
choose the Settings— ^Communications... (ALT, S, C) command, and select: 
9600 Baud Rate, 8 Data Bits, 1 Stop Bit, Parity None, Xon/Xoff Flow Control, 
and the PC's RS-232 interface connector to which the RS-232 cable was 
attached. Choose the OK button. 

You should now be able to press the Return key in the Terminal window to 
see the HP 64700's Terminal Interface prompt (for example, "R>", "M>", "U>", 
etc.). If you see the prompt, you have verified RS-232 communication. If you 
do not see the prompt, refer to "If you cannot verify RS-232 communication". 

6 Exit the Terminal window. 
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Step 2. Install the firmware update utility 

The firmware update utility and emulation and analysis firmware require 
about 1.5 Mbytes of disk space. 



1 Start MS Windows in the 386 enhanced mode. 



2 Insert the HP 64700 EMULATION AND ANALYSIS FIRMWARE 1 of 2 
disk into floppy disk drive A or B. 

3 Choose the File— >Run... (ALT, F, R) command in the Windows 
Program Manager. Enter "a:\setup" (or "b:\setup" if you installed the 
floppy disk into drive B) in the Command Line text box. 



Command Line: 



OK 



a:\setupj 



Cancel 



□ Run Minimized 



Browse.. 



Help 



Then, choose the OK button. Follow the instructions on the screen. 

You will be asked to enter the installation path. The default installation path 
is C:\HP64700. 



Installation Path for HP64700 Firmware Utility 



The setup program will copy the 64700 
Firmware Update Utility into the following 
directory. 



Path: 



C:\HPG4700 



The file 64700tab will be placed in the "tables" 
subdirectory. You may need to modify this emulator 
device table to reflect your PC setup. 
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Follow the remaining instructions to install the firmware update utility and 
the HP 64700 system firmware. 

4 After completing the installation, use the editor of your choice and 
edit the C:\CONFIG.SYS file to include these lines: 



BREAK=ON 
FILES=20 

BREAK=ON allows the system to check for two break conditions: 
CTRL+Break, and CTRL+c. 

FILES=20 allows 20 files to be accessed concurrently. This number must be 
at LEAST 20 to allow the firmware update utility to operate properly. 

5 If you installed the files in a path other than the default (C:\HP64700), 
edit the AUTOEXEC.BAT file to set the HP64700 and HPTABLES 
environment variables. For example: 

SET HP64 7 00=C : \INSTPATH 

SET HP TABLE S=C : \ INSTPATH\ TABLES 

6 If you are using the COM3 or COM4 ports, you need to edit the 
<installation_path>\TABLES\64700TAB file. The default file contains 
entries to establish the communications connection for COM1 and 
COM2. The content of this file is: 

EMUL_COMl unknown COM1 OFF 9 60 0 NONE ON 1 8 
EMUL_COM2 unknown COM2 OFF 9 60 0 NONE ON 1 8 

Either add another line or modify one of the existing lines. For example: 

EMUL_COM3 unknown COM3 OFF 9 60 0 NONE ON 1 8 
EMUL_COM4 unknown COM4 OFF 9 60 0 NONE ON 1 8 

Firmware update utility installation is now complete. The PC needs to be 
rebooted to enable the changes made to the CONFIG.SYS and 
AUTOEXEC.BAT files. To reboot, press the CTRL+ALT+DEL keys 
simultaneously. 
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Step 3. Run PROGFLASH to update HP 64700 
firmware 

1 Start MS Windows in the 386 enhanced mode. 

2 If the "HP 64700 Firmware Utility" group box is not opened, open it 
by double-clicking the icon. 

3 Double-click the "PROGFLASH" icon. (You can abort the 
PROGFLASH command by pressing CTRL+c.) 

4 Enter the number that identifies the emulator (in other words, HP 
64700) you want to update. 

5 Enter the number that identifies the product whose firmware you 
want to update. 

6 Enter "y" to enable status messages. 

The PROGFLASH command downloads code from files on the host computer 
into Flash EPROM memory in the HP 64700. 

You can display firmware version information and verify the update by 
choosing the Help— > About Debugger/Emulator... (ALT, H, D) command in 
the Real-Time C Debugger. 
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Glossary Defines terms that are used in 
the debugger help information. 



analyzer An instrument that captures data on signals of interest at discreet 
periods. The emulation bus analyzer captures emulator bus cycle 
information synchronously with the processor's clock signal. 

arm condition A condition that enables the analyzer. The analyzer is 
always armed unless you set the analyzer up to be armed by a signal received 
on the BNC port; when you do this, you can identify the arm condition in the 
trace specification by selecting arm in the Condition dialog boxes. 

background memory A separate memory system, internal to the emulator, 
out of which the background monitor executes. 

background monitor program An emulation monitor program that 
executes out of background memory. 

breakpoint An address you identify in the user program where program 
execution is to stop. Breakpoints let you look at the state of the target 
system at particular points in the program. 

break macro A breakpoint followed by any number of macro commands 
(which are the same as command file commands) . 

control menu The menu that is accessed by clicking the control menu box 
in the upper left corner of a window. You can also access control menus by 
pressing the "ALT" and "-" keys. 

count condition Specifies whether time or the occurrences of a particular 
state are counted for each state in the trace buffer. 

coverage measurements Measurements which show the code that has 
been accessed during program execution. 

embedded microprocessor system The microprocessor system that the 
emulator plugs into. 
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emulation memory Memory provided by the emulator that can be used in 
place of memory in the target system. 

emulation monitor A program, executed by the emulation microprocessor 
(as directed by the emulation system controller), that gives the emulator 
access to target system memory, microprocessor registers, and other target 
system resources. 

emulator An instrument that performs just like the microprocessor it 
replaces, but at the same time, it gives you information about the operation of 
the processor. An emulator gives you control over target system execution 
and allows you to view or modify the contents of processor registers, target 
system memory, and I/O resources. 

enable condition Specifies the first condition in a two-step sequential 
trigger condition. 

enable store condition Specifies which states get stored in the trace 
buffer while the analyzer searches for the enable condition. 

foreground memory The memory system out of which user programs 
execute. Foreground memory is made up of emulation memory and target 
system memory. 

foreground monitor program An emulation monitor program that 
executes out of the same memory system as user programs. This memory 
system is known as foreground memory and is made up of emulation memory 
and target system memory. The emulator only allows foreground monitor 
programs in emulation memory. 

guarded memory Memory locations that should not be accessed by user 
programs. These locations are specified when mapping memory. If the user 
program accesses a location mapped as guarded memory, emulator execution 
breaks into the monitor. 

macro Refers to a break macro, which is a breakpoint followed by any 
number of macro commands (which are the same as command file 
commands). 
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monitor A program, executed by the emulation microprocessor (as directed 
by the emulation system controller) , that gives the emulator access to target 
system memory, microprocessor registers, and other target system resources. 

mx flag The m flag determines whether the data length is 16-bit or 8-bit. 
The data length is 16-bit when flag m is "0" and 8-bit when it is "1". 

The x flag determines whether index register X and index register Y are used 
as 16-bit registers or as 8-bit registers. The registers are used as 16-bit 
registers when flag x is "0" and as 8-bit registers when it is "1". 

object file An IEEE-695 format absolute file that can be loaded into 
emulation or target system memory and executed by the debugger. 

popup menu A menu that is accessed by clicking the right mouse button in 
a window. 

prestore condition Specifies the states that may be stored before each 
normally stored state. Up to two states may be prestored for each normally 
stored state. 

primary branch condition Specifies a condition that causes the analyzer 
to begin searching at another level. 

restart condition Specifies the condition that restarts the two-step 
sequential trigger. In other words, if the restart condition occurs while the 
analyzer is searching for the trigger condition, the analyzer starts looking for 
the enable condition again. 

secondary branch condition Specifies a condition that causes the 
analyzer to begin searching at another level. If a state satisfies both the 
primary and secondary branch conditions, the primary branch will be taken. 

sequence levels Levels in the analyzer that let you specify a complex 
sequential trigger condition. For each level, the analyzer searches for 
primary and secondary branch conditions. You can specify a different store 
condition for each level. The Page button toggles the display between 
sequence levels 1 through 4 and sequence levels 5 through 8. 

state qualifier A combination of address, data, and status values that 
identifies particular states captured by the analyzer. 
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status values Values that identify the types of microprocessor bus cycles 
recognized by the analyzer. You can include status values (along with 
address and data values) when specifying trigger and store conditions. The 
status values defined for the M37700 emulator are: 



bg 


Background cycle 


byte 


Byte access cycle 


cpu 


CPU cycle 


data 


Data access cycle 


dataread 


Data read cycle 


datawrite 


Data write cycle 


dma 


DMA cycle 


dmaread 


DMA read cycle 


dmawrite 


DMA write cycle 


exec 


Execution cycle 


fetch 


Fetch cycle 


fg 


Foreground cycle 


hold 


Hold cycle 


mx 


MX flag cycle 


read 


Read cycle 


ref 


Refresh cycle 


word 


Word access cycle 


write 


Write cycle 



Glossary Defines terms that are used in the debugger help information. 



store condition Specifies which states get stored in the trace buffer. 

In the "Find Then Trigger" trace set up, the store condition specifies the 
states that get stored after the trigger. 

In the "Sequence" trace set up, each sequence level has a store condition that 
specifies the states that get stored while looking for the primary or secondary 
branch conditions. 

target system The microprocessor system that the emulator plugs into. 

trace state The information captured by the analyzer on a particular 
microprocessor bus cycle. 

transfer address The program's starting address defined by the software 
development tools and included with the symbolic information in the object 
file. 

trigger The captured analyzer state about which other captured states are 
stored. The trigger state specifies when the trace measurement is taken. 

trigger condition Specifies the condition that causes states to be stored in 
the trace buffer. 

trigger position Specifies whether the state that triggered the analyzer 
appear at the start, center, or end of the trace buffer. In other words, the 
trigger position specifies whether states are stored after, about, or before the 
trigger. 

trigger store condition Specifies which states get stored in the trace 
buffer while the analyzer searches for the trigger condition. 

watchpoint A variable that has been placed in the WatchPoint window 
where its contents can be readily displayed and modified. 
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Index 




! /RDY signal, enabling or disabling, 79 

A A-D Conversion Registers window, 402, 406 

A7700, assembling and linking the foreground monitor with, 447 

accumulated count information, displaying, 159, 363 

Add to Watch command, 375 

addresses, searching, 108, 349 

analyzer, 485-487, 489-490 

analyzer trace signals, 449-450 

analyzer, editing the trace specification, 173, 244 

analyzer, halting, 157, 257 

analyzer, repeating last trace, 157, 258 

analyzer, setting up with "Find Then Trigger", 164, 248-251 

analyzer, setting up with "Sequence", 168, 252-255 

analyzer, setting up with "Trigger Store", 161, 245-247 

analyzer, tracing until halt, 157, 256 

appendix 135 

arguments, function, 404, 438, 440-441 

arm condition, 94, 164, 168, 259-261, 295, 485-487, 489-490 

arrays (C operators), 192 

ASCII values in Memory window, 133, 412 

Assemble... (ALT, A) command, 275 

assembler, in-line, 275 

assembly instructions, specifying mx flag, 105 

assembly language instructions, stepping multiple, 120, 220-222 

assembly language instructions, stepping single, 118, 218 

assembly language source files, 437 

auto variables, 130-132 

AUTOEXEC.BAT file, 481-482 

B background memory, 485-487, 489-490 
background monitor, 443 

background monitor program, 485-487, 489-490 
background monitor, selecting, 88, 283-285 
background operation, tracing, 383 
BackTrace window, 404 
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BackTrace window, displaying source files, 373 

Basic Registers window, 405 

beep, sounding from command file, 379 

BNC port, driving the trigger signal, 293-294 

BNC port, output the trigger signal, 94 

BNC port, receiving an arm condition from, 295 

BNC port, receiving an arm condition input from, 94 

BNC port, setting up, 94 

BP marker, 33, 35, 127, 225-230, 421 

break into monitor, 122, 223 

break macro, 485-487, 489-490 

break macros, command summary, 180 

break macros, deleting, 129, 230 

break macros, listing, 127, 231-232 

break macros, setting, 127, 227-229 

break on writes to ROM, enabling or disabling, 80 

breakpoint, 485-487, 489-490 

Breakpoint-Delete at Cursor (ALT, B, D) command, 226 

Breakpoint-Delete Macro (ALT, B, L) command, 230 

Breakpoint-Edit... (ALT, B, E) command, 231-232 

Breakpoint-Set at Cursor (ALT, B, S) command, 225 

Breakpoint-Set Macro... (ALT, B, M) command, 227-229 

breakpoints, deleting, 35, 126, 226 

breakpoints, disabling, 126 

breakpoints, listing, 127, 231-232 

breakpoints, setting, 33, 125, 225 

bus cycles, displaying, 158, 362 

Button window, 406 

Button window, editing, 65, 321 

buttons that execute command files, creating, 65 

C operators, 192 

callers (of a function), tracing, 47, 151, 237-238 
Clear Breakpoint command, 374 
clipboard, 55 

clock source (emulator), selecting, 75, 82 
clock speeds greater than 16 MHz, 81 
command file execution, exiting, 381 
command files, command summary, 180 
command files, comments, 384 
command files, creating, 63, 200 
command files, executing, 64, 203-204 



command files, inserting wait delays, 385-386 
command files, locating cursor, 380 
command files, parameters, 203-204 
command files, sounding beep, 379 
command files, turning logging on or off, 201-202 
command line options, 58 
command summary, 180 
comments in command files, 384 
communications (emulator), setting up, 290-292 
CONFIG.SYS file, 481-482 
configuration, emulator, 276-279 
configurations, saving and loading, 95-96 
Continuous Update (ALT, -, U) command, 338 
control menu, 485-487, 489-490 
Copy-Destination... (ALT, -, P, D) command, 320 
Copy-Registers (ALT, -, P, R) command, 338 
Copy-Window (ALT, -, P, W) command, 319 
count condition, 485-487, 489-490 
count conditions, 259-261 

count information, displaying accumulated, 159, 363 
count information, displaying relative, 159, 364 
coverage (execution), displaying, 146, 296-297 
coverage (execution), resetting, 298 
coverage measurements, 485-487, 489-490 
CTRL key and double-clicks, 55 
cursor, locating from command file, 380 
cut and paste, 55 

DCE or DTE selection and RS-232 cable, 465 

debugger overview, 4 

debugger startup options, 58 

debugger windows, opening, 60 

debugger, arranging icons in window, 309 

debugger, cascaded windows, 309 

debugger, exiting, 49-50, 58, 210 

debugger, exiting locked, 211 

debugger, installing software, 467 

debugger, opening windows, 310-312 

debugger, starting, 26, 57, 470 

debugger, tiled windows, 309 

demo program, loading, 31 

demo program, mapping memory, 29-30 



demo program, running, 34 

demo programs, 24 

DeMorgan's law, 259-261 

dialog boxes, file selection, 212 

directories, search path, 350 

directories, source, 314 

display internal RAM and SFR, 135 

display mode, mixed, 104-105 

display mode, source only, 104 

display mode, toggling, 341-342 

Display-Select Source... (ALT, -, D, L) command, 343 

DMA cycles, trace, 91 

do while statements (C), single-stepping, 437 
double-clicks and the CTRL key, 55 
dynamic variables, 233-234, 368, 436 

embedded microprocessor system, 485-487, 489-490 
emulation memory, 485-487, 489-490 
emulation memory model, selecting, 82 

emulation memory, copying target system memory into, 139, 333 

emulation microprocessor, resetting, 123, 224 

emulation monitor, 485-487, 489-490 

emulation monitor programs, 443 

emulation pod, pod configuration, 93 

emulation RAM, mapping internal RAM and SFR, 86 

emulator, 485-487, 489-490 

emulator clock source, selecting, 75 

emulator configuration, 74, 276-279 

emulator configuration, loading, 96, 207 

emulator configuration, saving, 95, 208 

emulator hardware options, setting, 75-82 

enable condition, 485-487, 489-490 

enable store condition, 485-487, 489-490 

environment variables, 107 

environment variables, HP64700, 481-482 

environment variables, HPTABLES, 481-482 

environment variables, PATH, 481-482 

environment, loading, 205 

environment, saving, 206 

ethernet address, 460-463 

Evaluate It command, 374 

execution coverage, displaying, 146, 296-297 



execution coverage, resetting, 298 
Execution-Break (F4), (ALT, E, B) command, 223 
Execution-Reset (ALT, E, E) command, 224 
Execution-Run (F5), (ALT, E, U) command, 213 
Execution-Run to Caller (ALT, E, T) command, 215 
Execution-Run to Cursor (ALT, E, C) command, 214 
Execution-Run... (ALT, E, R) command, 216-217 
Execution-Single Step (F2), (ALT, E, N) command, 218 
Execution-Step Over (F3), (ALT, E, O) command, 219 
Execution-Step... (ALT, E, S) command, 220-222 
exiting command file execution, 381 
Expression window, 408 
Expression window, clearing, 323 
Expression window, displaying expressions, 324 
expressions, 188 
expressions, displaying, 324 
extended settings, 302-308 

externals, displaying symbol information, 112, 352 
file selection dialog boxes, 212 

File-Command Log-Log File Name... (ALT, F, C, N) command, 200 

File-Command Log-Logging OFF (ALT, F, C, F) command, 202 

File-Command Log-Logging ON (ALT, F, C, O) command, 201 

File-Copy Destination... (ALT, F, P) command, 209 

File-Exit (ALT, F, X) command, 210 

File-Exit HW Locked (ALT, F, H) command, 211 

File-Load Debug... (ALT, F, D) command, 205 

File-Load Emulator Config... (ALT, F, E) command, 207 

File-Load Object... (ALT, F, L) command, 197-199 

File-Run Cmd File... (ALT, F, R) command, 203-204 

File-Save Debug... (ALT, F, S) command, 206 

File-Save Emulator Config... (ALT, F, V) command, 208 

firmware update utility, installing, 481-482 

firmware update, connecting the HP 64700 to the PC, 479-480 

firmware version information, 313 

firmware, using PROGFLASH to update, 483 

font settings, 299-300 

fonts, changing, 61 

for statements (C), single-stepping, 437 
foreground memory, 485-487, 489-490 
foreground monitor, 443 

foreground monitor program, 485-487, 489-490 
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foreground monitor, assembling, linking with A7700, 447 

foreground monitor, notes on, 447 

foreground monitor, selecting, 89, 283-285 

foreground operation, tracing, 383 

function arguments, 404, 438, 440-441 

function codes, 485-487, 489-490 

function keys, 56 

functions, displaying symbol information, 111, 352 
functions, running until return, 41, 121, 215 
functions, searching, 108, 347 
functions, stepping over, 42, 119, 219 
functions, tracing callers, 47, 151, 237-238 
functions, tracing execution within, 153, 239 
functions, tracing flow, 46, 150, 236 

G gateway address, 460-463 

global assembler symbols, displaying, 114, 354 
global symbols, displaying, 112, 352 
global variables, 112, 154-155, 352 
glossary, 485-487, 489-490 

guarded memory, 84, 280-282, 423, 485-487, 489-490 

H hardware options, setting, 75-82 
hardware requirements, 455 
hardware, locking on exit, 211 

Help-About Debugger/Emulator... (ALT, H, D) command, 313 
high speed access, 78 

high speed access, enabling or disabling, 78 
Hold cycles, trace, 92 
hostname, 290-292 

HP 64146/7 emulator, plugging-in, 69-70 

HP 64700 firmware update utility, installing, 481-482 

HP 64700 firmware update, connecting the HP 64700 to the PC, 479-480 

HP 64700 firmware, using PROGFLASH to update, 483 

HP 64700, connecting to the PC, 457 

HP 64700, connecting via LAN, 460-463 

HP 64700, connecting via RS-232, 457-459 

HP 64700, connecting via RS-422, 464 

HP64700 environment variable, 481-482 

HPTABLES environment variable, 481-482 
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I I/O locations, displaying, 142 
I/O locations, editing, 143 
I/O locations, guarding, 269-270 
I/O locations, specifying, 325 
I/O window, 411 

I/O window, turning polling ON or OFF, 98 
ICC7700, compiling programs with, 438 
icon, for a different emulator, 58 
icons (debugger window), arranging, 309 
IEEE-695 object files, 437 

in-circuit operation, configuring the emulator for, 71-72 

in-line assembler, 275 

installation path, 467 

internal RAM and SFR, displaying, 135 

internal RAM and SFR, mapping, 86 

internal RAM/ROM/SFR, in pod configuration, 93, 288-289 

internals, displaying symbol information, 113, 353 

Internet Address, 290-292, 460-463, 466-469 

Interrupt Control Registers window, 409 

interrupts (target system), 443 

interset operators, 259-261 

intraset operators, 259-261 

introduce /RDY signal, 79 

intrusion, monitor, 98, 267-268 

L labels, 190-191,275 
LAN cards, 455-456 
LAN communication, 290-292, 470 
LAN, connecting HP 64700, 460-463 
levels, trace sequence, 168, 173, 252-255, 266 
limitations, Symbol window, 426 
line (source file), running until, 43, 121, 214 
link level address, 460-463 
list file, changing the destination, 61 
list file, copying window contents to, 60 
listing files, specifying, 209, 320 
local assembler symbols, displaying, 114, 355 
local symbols, displaying, 113, 353 
local variables, 113-114, 353 
lock hardware on exit, 211 
log (command) files, 63, 200-204 
logical operators, 164, 168, 259-261 
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M macro, 485-487, 489-490 

MCCM77, compiling programs with, 440 

memory (target system), copying into emulation memory, 139, 333 
memory type, 84, 280-282 
Memory window, 412 

Memory window, displaying 16-bit values, 328 

Memory window, displaying 32-bit values, 329 

Memory window, displaying bytes, 328 

Memory window, displaying multi-column format, 328 

Memory window, displaying single-column format, 327 

Memory window, turning polling ON or OFF, 98 

memory, copying, 138, 331 

memory, displaying, 133 

memory, editing, 137 

memory, loading from stored file, 335 

memory, mapping, 83-87, 280-282 

memory, mapping for demo program, 29-30 

memory, modifying a range, 140, 332 

memory, searching for a value or string in, 141 

memory, storing to a binary file, 336 

microprocessor, resetting, 123, 224 

mixed display mode, 104, 341, 437 

Mode Registers window, 413 

monitor, 485-487, 489-490 

monitor intrusion, 98, 267-268 

monitor programs, 443 

monitor, selecting the type, 88-90 

mxflag, display mixed mode, 105 

N NC77, compiling programs with, 441 
no-operation command, 384 
numeric constants, 189 

O object file, 485-487, 489-490 
object files, IEEE-695, 437 
object files, loading, 103, 197-199 
object files, loading the foreground monitor, 89 
operators, C, 192 
operators, interset, 259-261 
operators, intraset, 259-261 
operators, logical, 164, 168, 259-261 
optimization option, compiler, 146, 438, 440-441 
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options, command line, 58 
Other Registers window, 415 
overview, 4 

P parameters, command file, 203-204 
paste, cut and, 55 

PATH environment variable, 481-482 

path for source file search, 107, 350 

paths for source files, prompting, 382 

patterns, trace, 164, 168, 248-255, 259-263 

PC, connecting HP 64700, 457 

performance (PC), optimizing for the debugger, 476 

platform requirements, 455 

pointers (C operators), 192 

polling for debugger windows, turning ON or OFF, 98 

popup menu, 485-487, 489-490 

popup menus, accessing, 372 

Port Registers window, 417 

port, BNC, 94, 259-261, 293-295 

port, communication, 290-292 

pragma statements (C), source file information, 437 

prestore condition, 164, 168, 248-255, 430, 485-487, 489-490 

primary branch condition, 168, 252-255, 485-487, 489-490 

processor mode, selecting, 78 

processor mode, setting for demo program, 27 

processor type, selecting, 77 

processor, resetting, 123, 224 

PROGFLASH firmware update utility, 483 

program counter, 118, 122, 213, 216-217, 220-222, 421 

program modules, displaying symbol information, 111, 351 

programs, compiling with ICC7700, 438 

programs, compiling with MCCM77, 440 

programs, compiling with NC77, 441 

programs, demo, 24 

programs, loading, 103, 197-199 

programs, running, 122, 213, 216-217 

programs, stopping execution, 122 

Pulse Motor Control Registers window, 419 

Q qualifier, state, 161, 245-247 
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R real-time mode, disabling, 98, 268 
real-time mode, enabling, 98, 267 
real-time options, setting, 97-100 

RealTime-I/O Polling-OFF (ALT, R, I, F) command, 270 
RealTime-I/O Polling-ON (ALT, R, I, O) command, 269 
RealTime-Memory Polling-OFF (ALT, R, M, F) command, 274 
RealTime-Memory Polling-ON (ALT, R, M, 0) command, 273 
RealTime-Monitor Intrusion- Alio wed (ALT, R, T, A) command, 268 
RealTime-Monitor Intrusion-Disallowed (ALT, R, T, D) command, 267 
RealTime-Watchpoint Polling-OFF (ALT, R, W, F) command, 272 
RealTime-Watchpoint Polling-ON (ALT, R, W, O) command, 271 
Refresh cycles, trace, 92 
register variables, 438, 440-441 
Register window, copying information from, 338 
Register windows, continuous update, 338 
registers, displaying, 44-45, 144 
registers, editing, 145 

relative count information, displaying, 159, 364 

requirements, hardware, 455 

requirements, platform, 455 

reset, coverage, 146, 298 

reset, emulator, 123, 224 

reset, emulator status, 423 

reset, running from target system, 122, 216-217 

resetvalue for stack, 28 

restart condition, 164, 248-251, 485-487, 489-490 
return (function), running until, 41, 121, 215 
ROM, enabling or disabling breaks on writes to, 80 
RS-232 cable and DCE or DTE selection, 465 
RS-232, connecting HP 64700, 457-459 
RS-422, connecting HP 64700, 464 
run to caller, interrupting, 391 
Run to Cursor command, 375 

S search path for source files, 107, 350 

Search- Address... (ALT, -, R, A) command, 349 
Search-Function... (ALT, -, R, F) command, 347 
Search-String... (ALT, -, R, S) command, 346 
Search... (ALT, -, R) command, 329 

secondary branch condition, 168, 252-255, 485-487, 489-490 
sequence levels, 266, 485-487, 489-490 
service ports, TCP, 460-463 
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Set Breakpoint command, 374 

Settings-BNC-BNC Drive Trigger (ALT, S, B, D) command, 293-294 
Settings-BNC-BNC Receive Arm (ALT, S, B, R) command, 295 
Settings-Communication... (ALT, S, C) command, 290-292 
Settings-Coverage-Coverage OFF (ALT, S, V, F) command, 297 
Settings-Coverage-Coverage ON (ALT, S, V, O) command, 296 
Settings-Coverage-Coverage Reset (ALT, S, V, R) command, 298 
Settings-Emulator Config-Hardware... (ALT, S, E, H) command, 276-279 
Settings-Emulator Config-Memory Map... (ALT, S, E, M) command, 280-282 
Settings-Emulator Config-Monitor... (ALT, S, E, 0) command, 283-285 
Settings-Emulator Config-Pod... (ALT, S, E, P) command, 288-289 
Settings-Emulator Config-Trace Options... (ALT, S, E, T) command, 286-287 
Settings-Extended-Load Error Abort-On (ALT, S, X, L, 0) command, 305-306 
Settings-Extended-Source Path Query-On (ALT, S, X, S, O) command, 
307-308 

Settings-Extended-Trace Cycles-Both (ALT, S, X, T, B) command, 304 

Settings-Extended-Trace Cycles-Monitor (ALT, S, X, T, M) command, 303 

Settings-Extended-Trace Cycles-User (ALT, S, X, T, U) command, 302 

Settings-Font... (ALT, S, F) command, 299-300 

Settings-Tabstops... (ALT, S, T) command, 301 

single-step one line, 36 

software, installing debugger, 467 

Source at Stack Level command, 373 

source directory, 314 

source display mode, toggling, 341-342 

source file line, running until, 43, 121, 214 

source files, displaying, 32, 106, 343 

source files, displaying from BackTrace window, 373 

source files, information generated for pragma statements, 437 

source files, prompting for paths, 382 

source files, searching for addresses, 108, 349 

source files, searching for function names, 108, 347 

source files, searching for strings, 109, 346 

source files, specifying search directories, 107 

source lines, stepping multiple, 120, 220-222 

source lines, stepping single, 118, 218 

source only, displaying, 104, 363 

source only, displaying in Memory window, 341-342 

Source window, 421 

Source window, setting tabstops, 62 

Source window, specifying mx flag, 344-345 
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Source window, toggling the display mode, 341-342 
SRCPATH environment variable, 107 
stack pointer, setting up the reset value, 28 
startup options, 58 

state qualifier, 161, 245-247, 485-487, 489-490 

status register, editing, 339 

status values, 449-450, 485-487, 489-490 

Status window, 423 

step multiple lines, 37 

step one line, 36 

step over, interrupting, 391 

store condition, 485-487, 489-490 

store conditions, 259-261 

strings, displaying symbols containing, 117, 358 

strings, searching memory for, 141, 329 

strings, searching source files, 109, 346 

structures (C operators), 192 

subnet mask, 460-463 

subroutines, stepping over, 219 

Symbol window, 426 

Symbol window, copying information, 357-358 
Symbol window, searching for strings, 358 
symbols, 190-191 
system setup, 456 

tabstop settings, 301 

tabstops in the Source window, setting, 62 
target system, 485-487, 489-490 
target system interrupts, 443 

target system memory, copying into emulation memory, 139, 333 

TCP service ports, 460-463 

telnet, 460-463, 466-469 

text, selecting, 55 

Timer Registers window, 428 

tool type, 81 

trace DMA cycles, 286-287 

trace DMA cycles, trace option, 91 

trace foreground/background operation, 383 

trace Hold cycles, 286-287 

trace Hold cycles, trace option, 92 

trace options, 286-287 

trace patterns, 164, 168, 248-255, 259-263 



trace range, 264-265 

trace Refresh cycles, 286-287 

trace Refresh cycles, trace option, 92 

trace settings, 259-261 

trace signals, 449-450 

trace specification, copying, 366 

trace specification, editing, 173, 244 

trace specification, loading, 176 

trace specification, specifying the destination, 367 

trace specification, storing, 175 

trace state, 485-487, 489-490 

trace state, searching for in Trace Window, 366 

Trace window, 430 

Trace window, copying information, 364-365 

Trace window, displaying accumulated count information, 363 

Trace window, displaying bus cycles, 362 

Trace window, displaying relative count information, 364 

Trace window, displaying source only, 363 

trace, trace options, 91-92 

Trace-Again (F7), (ALT, T, A) command, 258 

Trace-Edit... (ALT, T, E) command, 244 

Trace-Find Then Trigger... (ALT, T, D) command, 248-251 

Trace-Function Caller... (ALT, T, C) command, 237-238 

Trace-Function Flow (ALT, T, F) command, 236 

Trace-Function Statement... (ALT, T, S) command, 239 

Trace-Halt (ALT, T, H) command, 257 

Trace-Sequence... (ALT, T, Q) command, 252-255 

Trace-Trigger Store... (ALT, T, T) command, 245-247 

Trace-Until Halt (ALT, T, U) command, 256 

Trace-Variable Access... (ALT, T, V) command, 240-241 

Trace-Variable Break... (ALT, T, B) command, 242-243 

transfer address, 34, 120, 122, 216-217, 220-222, 485-487, 489-490 

trigger, 485-487, 489-490 

trigger condition, 485-487, 489-490 

trigger position, 485-487, 489-490 

trigger state, searching for in Trace window, 365 

trigger store condition, 485-487, 489-490 

tutorial, 24 

type of memory, 84, 280-282 

UART0 Registers window, 431 
UART1 Registers window, 433 



unary minus operator, 192 
unions (C operators), 192 
user ID, 467 

user programs, loading, 103 
user-defined symbols, creating, 115, 359 
user-defined symbols, deleting, 117, 361 
user-defined symbols, displaying, 116, 357 
Utilities-Copy... (ALT, -, U, C) command, 331 
Utilities-Fill... (ALT, -, U, F) command, 332 
Utilities-Image... (ALT, -, U, I) command, 333 
Utilities-Load... (ALT, -, U, L) command, 335 
Utilities-Store... (ALT, -, U, S) command, 336 

V values, searching memory for, 141, 329 

Variable-Edit... (ALT, V, E) command, 233-234 
variables, auto, 130-132 
variables, displaying, 38, 130 
variables, dynamic, 233-234, 368, 436 
variables, editing, 39, 131, 233-235 
variables, environment, 107 
variables, global, 112, 154-155, 352 
variables, local, 113-114, 353 

variables, monitoring in the WatchPoint window, 40, 132 
variables, register, 438, 440-441 

variables, tracing a particular value and breaking, 155, 242-243 
variables, tracing accesses, 48, 154, 240-241 
version information, 313, 475 

W WAIT command, 315-316 

wait delays, inserting in command files, 385-386 
watchdog timer, 80 

Watchdog Timer Registers window, 435 
Watchdog Timer setting, enabling or disabling, 80 
watchpoint, 485-487, 489-490 
WatchPoint window, 436 

WatchPoint window, monitoring variables in, 40, 132 
WatchPoint window, turning polling ON or OFF, 98 
watchpoints, editing, 368 
while statements (C), single-stepping, 437 
window contents, copying to the list file, 60 
Window-1-9 (ALT, W, 1-9) command, 310-311 
Window-Arrange Icons (ALT, W, A) command, 309 
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Window-Cascade (ALT, W, C) command, 309 

Window-More Windows... (ALT, W, M) command, 312 

Window-Tile (ALT, W, T) command, 309 

windows (debugger), opening, 310-312 

windows of program execution, tracing, 1 73 

write cycles, to emulation RAM, internal RAM and SFR, 86 

writes to ROM, enabling or disabling breaks on, 80 



Certification and Warranty 



Certification 

Hewlett-Packard Company certifies that this product met its published 
specifications at the time of shipment from the factory. Hewlett-Packard further 
certifies that its calibration measurements are traceable to the United States 
National Bureau of Standards, to the extent allowed by the Bureau's calibration 
facility, and to the calibration facilities of other International Standards 
Organization members. 



Warranty 

This Hewlett-Packard system product is warranted against defects in materials and 
workmanship for a period of 90 days from date of installation. During the warranty 
period, HP will, at its option, either repair or replace products which prove to be 
defective. 

Warranty service of this product will be performed at Buyer's facility at no charge 
within HP service travel areas. Outside HP service travel areas, warranty service 
will be performed at Buyer's facility only upon HP's prior agreement and Buyer 
shall pay HP's round trip travel expenses. In all other cases, products must be 
returned to a service facility designated by HP. 

For products returned to HP for warranty service, Buyer shall prepay shipping 
charges to HP and HP shall pay shipping charges to return the product to Buyer. 
However, Buyer shall pay all shipping charges, duties, and taxes for products 
returned to HP from another country. HP warrants that its software and firmware 
designated by HP for use with an instrument will execute its programming 
instructions when properly installed on that instrument. HP does not warrant that 
the operation of the instrument, or software, or firmware will be uninterrupted or 
error free. 



Limitation of Warranty 



The foregoing warranty shall not apply to defects resulting from improper or 
inadequate maintenance by Buyer, Buyer-supplied software or interfacing, 
unauthorized modification or misuse, operation outside of the environment 
specifications for the product, or improper site preparation or maintenance. 

No other warranty is expressed or implied. HP specifically disclaims the 
implied warranties of merchantability and fitness for a particular purpose. 

Exclusive Remedies 

The remedies provided herein are buyer's sole and exclusive remedies. HP 
shall not be liable for any direct, indirect, special, incidental, or consequential 
damages, whether based on contract, tort, or any other legal theory. 

Product maintenance agreements and other customer assistance agreements are 
available for Hewlett-Packard products. 

For any assistance, contact your nearest Hewlett-Packard Sales and Service Office. 



Safety 



Summary of Safe Procedures 

The following general safety precautions must be observed during all phases 
of operation, service, and repair of this instrument. Failure to comply with 
these precautions or with specific warnings elsewhere in this manual violates 
safety standards of design, manufacture, and intended use of the instrument. 
Hewlett-Packard Company assumes no liability for the customer's failure to 
comply with these requirements. 

Ground The Instrument 

To minimize shock hazard, the instrument chassis and cabinet must be 
connected to an electrical ground. The instrument is equipped with a 
three-conductor ac power cable. The power cable must either be plugged 
into an approved three-contact electrical outlet or used with a three-contact 
to two-contact adapter with the grounding wire (green) firmly connected to 
an electrical ground (safety ground) at the power outlet. The power jack and 
mating plug of the power cable meet International Electrotechnical 
Commission (IEC) safety standards. 

Do Not Operate In An Explosive Atmosphere 

Do not operate the instrument in the presence of flammable gases or fumes. 
Operation of any electrical instrument in such an environment constitutes a 
definite safety hazard. 

Keep Away From Live Circuits 

Operating personnel must not remove instrument covers. Component 
replacement and internal adjustments must be made by qualified 
maintenance personnel. Do not replace components with the power cable 
connected. Under certain conditions, dangerous voltages may exist even with 
the power cable removed. To avoid injuries, always disconnect power and 
discharge circuits before touching them. 



Do Not Service Or Adjust Alone 

Do not attempt internal service or adjustment unless another person, capable 
of rendering first aid and resuscitation, is present. 

Do Not Substitute Parts Or Modify Instrument 

Because of the danger of introducing additional hazards, do not install 
substitute parts or perform any unauthorized modification of the instrument. 
Return the instrument to a Hewlett-Packard Sales and Service Office for 
service and repair to ensure that safety features are maintained. 

Dangerous Procedure Warnings 

Warnings, such as the example below, precede potentially dangerous 
procedures throughout this manual. Instructions contained in the warnings 
must be followed. 

Dangerous voltages, capable of causing death, are present in this instrument. 
Use extreme caution when handling, testing, and adjusting. 



Safety Symbols Used In Manuals 

The following is a list of general definitions of safety symbols used on 
equipment or in manuals: 

Instruction manual symbol: the product is marked with this symbol when it is 
necessary for the user to refer to the instruction manual in order to protect 
against damage to the instrument. 

Indicates dangerous voltage (terminals fed from the interior by voltage 
exceeding 1000 volts must be marked with this symbol). 

Protective conductor terminal. For protection against electrical shock in case 
of a fault. Used with field wiring terminals to indicate the terminal which 
must be connected to ground before operating the equipment. 

Low-noise or noiseless, clean ground (earth) terminal. Used for a signal 
common, as well as providing protection against electrical shock in case of a 
fault. A terminal marked with this symbol must be connected to ground in the 
manner described in the installation (operating) manual before operating the 
equipment. 

'rame or chassis terminal. A connection to the frame (chassis) of the 
quipment which normally includes all exposed metal structures. 

Alternating current (power line). 

Direct current (power line). 



Alternating or direct current (power line). 



The Caution sign denotes a hazard. It calls your attention to an operating 
procedure, practice, condition, or similar situation, which, if not correctly 
performed or adhered to, could result in damage to or destruction of part or 
all of the product. 



The Warning sign denotes a hazard. It calls your attention to a procedure, 
practice, condition or the like, which, if not correctly performed, could result 
in injury or death to personnel. 



